oss-forensics

Investigates GitHub repositories for supply chain compromise using multi-source forensic evidence collection.

7|4|Updated Jun 22, 2026
One-click install
npx skills add https://github.com/dbx0/skills --skill oss-forensics-dbx0
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oss-forensics
Source: https://github.com/dbx0/skills/tree/main/skills/forensics-dfir/collection/oss-forensics
Command: npx skills add https://github.com/dbx0/skills --skill oss-forensics-dbx0

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—via force-pushes, deleted commits, maintainer takeover, or dependency confusion—requires correlating evidence across git history, the GitHub API, the Wayback Machine, and GH Archive, which is tedious and error-prone to do manually. ## Core Features & Use Cases - Multi-Source Evidence Collection: Coordinates five specialist investigators covering local git analysis, GitHub REST API, Wayback Machine CDX, GH Archive BigQuery, and IOC enrichment. - Deleted Commit Recovery: Recovers force-pushed commits via direct patch URLs, BigQuery PushEvent payloads, and git fsck dangling-commit analysis. - Hypothesis Validation with Anti-Hallucination Guardrails: Every claim must cite evidence IDs that are mechanically verified against a SHA256-hashed evidence store before a report is accepted. - Use Case: A team suspects a dependency was swapped after a maintainer account anomaly. The skill extracts IOCs, detects force-push events in BigQuery, recovers the erased commits, validates the compromise hypothesis, and produces a structured forensic report with chain of custody. ## 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 recover force-pushed or deleted commits from a GitHub repository?

Try the direct patch URL github.com/OWNER/REPO/commit/SHA.patch first, which works for most recent force-pushes. If that fails, query GH Archive in BigQuery for the PushEvent containing the commit SHA, or run git fsck --lost-found on a local clone to find dangling commits.

How to detect a force push on a GitHub repository?

Query GH Archive in BigQuery for PushEvents where payload.size is greater than 0 but payload.distinct_size equals 0, which indicates commits were force-erased. Locally, git reflog and git fsck --unreachable also reveal rewritten history.

Does this investigation require Google Cloud or BigQuery access?

BigQuery access via gcloud application-default credentials is needed only for the GH Archive investigator. If unavailable, that investigator is skipped and noted in the report; git, GitHub API, and Wayback Machine investigators still run.

What GitHub API rate limits apply during an investigation?

Authenticated requests allow 5,000 per hour via GITHUB_TOKEN or the gh CLI, while unauthenticated requests are capped at 60 per hour and are unusable for investigations. The skill recommends conditional requests and monitoring the X-RateLimit-Remaining header.

How does the skill prevent fabricated forensic findings?

Every claim must cite evidence IDs stored in a SHA256-hashed evidence store, and a validator sub-agent mechanically confirms each cited ID exists before accepting a hypothesis. Unverified inferences are labeled as hypotheses and secrets are redacted in the final report.