oss-forensics

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

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/loteiron/ZeusAgent --skill oss-forensics-loteiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: oss-forensics
Source: https://github.com/loteiron/ZeusAgent/tree/main/optional-skills/security/oss-forensics
Command: npx skills add https://github.com/loteiron/ZeusAgent --skill oss-forensics-loteiron

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Determining whether an open-source repository was compromised requires correlating evidence across git history, GitHub APIs, archived web pages, and immutable event logs, which is slow and error-prone when done manually. ## 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. - Evidence Store with Integrity Checks: A CLI tool records every finding with SHA-256 hashes, chain-of-custody logging, and verification states to prevent fabricated claims. - Hypothesis Validation & Reporting: Mechanically validates cited evidence IDs before accepting hypotheses and generates a structured forensic report with timeline, IOC list, and recommendations. - Use Case: After a maintainer account is suspected of being hijacked, run the framework to recover force-pushed commits, detect deleted PRs, and produce an evidence-backed compromise verdict. ## Quick Start Ask the agent to investigate the GitHub repository owner/repo for signs of supply-chain compromise and generate a 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 the 7-phase framework: extract IOCs from the prompt, spawn specialist investigators for git, GitHub API, Wayback Machine, and GH Archive, then consolidate evidence, validate hypotheses, and generate a cited forensic report.

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

Force-pushed commits remain on GitHub servers until garbage collection. Recover them via the direct commit URL with .patch suffix, the /git/commits/SHA API endpoint, git fetch origin SHA, or git fsck for local dangling objects.

Does the GH Archive investigator require Google BigQuery access?▼

Yes, BigQuery queries against githubarchive tables need Google Cloud credentials via gcloud auth. If unavailable, that investigator is skipped and the limitation is documented; the other four investigators still cover most needs.

Why does the skill require two sources before marking evidence verified?▼

Single-source claims can be wrong or fabricated, so commit SHAs, URLs, and identifiers must be independently confirmed from at least two sources. Only multi-source-verified evidence may be cited as fact in validated hypotheses.

What are the limitations of GitHub forensic investigation?▼

Deleted issues and PRs do not appear in the GitHub API, GH Archive stores event metadata rather than file contents, and GitHub garbage collection eventually removes orphaned commits. Unauthenticated API use is limited to 60 requests per hour.