oss-forensics

Investigate GitHub supply-chain attacks through multi-source evidence collection and forensic reporting.

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill oss-forensics-vivekgoquest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: oss-forensics
Source: https://github.com/vivekgoquest/hermes-agent-stable/tree/main/optional-skills/security/oss-forensics
Command: npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill oss-forensics-vivekgoquest

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? When an open-source repository may have been compromised—through maintainer takeover, dependency confusion, force-push history erasure, or CI/CD injection—analysts need a rigorous, evidence-backed way to reconstruct what happened without fabricating claims. ## Core Features & Use Cases - 7-Phase Investigation Framework: Orchestrates up to 5 specialist sub-agents covering local git analysis, GitHub REST API, Wayback Machine, GH Archive/BigQuery, and IOC enrichment, each with strict role boundaries. - Tamper-Evident Evidence Store: A CLI tool records every finding with SHA-256 integrity hashes, chain-of-custody logging, verification states, and Markdown export for reports. - Deleted Content Recovery: Techniques to recover force-pushed commits, deleted issues, PRs, and releases via direct GitHub URLs, the git/commits API, git fetch by SHA, and archive.org snapshots. - Use Case: A maintainer suspects a contributor's account pushed a backdoored workflow file. The skill extracts IOCs, cross-references GH Archive PushEvents against the GitHub API to detect force-pushes, validates hypotheses against cited evidence, and produces a forensic report with a confidence-rated verdict. ## Quick Start Ask the agent to investigate the GitHub repository owner/repo for signs of supply-chain compromise and generate an evidence-backed forensic report.

Frequently Asked Questions about oss-forensics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I investigate a GitHub repository for supply chain compromise?▼

Run a structured forensic investigation that collects evidence from local git history, the GitHub REST API, Wayback Machine snapshots, and GH Archive BigQuery events. Findings are stored with integrity hashes, hypotheses are validated against cited evidence, and a final report states a verdict with confidence level.

How to recover force-pushed or deleted commits on GitHub?▼

Force-pushed commits remain on GitHub's servers until garbage collection. Recover them via the direct commit URL with a .patch suffix, the /git/commits/SHA API endpoint, or git fetch origin SHA in a local clone. GH Archive PushEvents reveal the pre-rewrite SHA.

Does GitHub forensics require BigQuery access?▼

No, BigQuery is optional. GH Archive queries via BigQuery provide tamper-proof event history, but if Google Cloud credentials are unavailable the other investigators—local git, GitHub API, Wayback Machine, and IOC enrichment—cover most investigation needs.

What GitHub API rate limits affect forensic investigations?▼

Authenticated GitHub API requests allow 5,000 per hour while unauthenticated requests allow only 60 per hour, which is unusable for investigations. Set a GITHUB_TOKEN or use the gh CLI, and monitor the X-RateLimit-Remaining header during pagination.

How are forensic hypotheses validated without hallucination?▼

Every claim must cite evidence IDs that a validator mechanically checks against the evidence store. Facts require confirmation from two or more independent sources, unverified inferences are labeled as hypotheses, and rejected hypotheses feed back for refinement up to three iterations.