oss-forensics

Aggregate evidence from GitHub API, GH Archive, Wayback Machine, and git history to identify supply-chain compromises.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/dawsonblock/HERMY --skill oss-forensics-dawsonblock
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oss-forensics
Source: https://github.com/dawsonblock/HERMY/tree/main/hermes-agent-2026.4.23/optional-skills/security/oss-forensics
Command: npx skills add https://github.com/dawsonblock/HERMY --skill oss-forensics-dawsonblock

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

OSS projects on GitHub are vulnerable to supply-chain attacks and deleted artifacts that obscure evidence. This skill provides a structured framework to collect, preserve, and correlate evidence from multiple sources (local Git history, GitHub API, GH Archive, and the Wayback Machine), enabling reproducible investigations and defensible conclusions.

Core Features & Use Cases

  • Phase-based investigation workflow: initialization, data collection, evidence consolidation, hypothesis formation and validation, and final reporting.
  • Multi-source evidence collection and cross-source verification to identify discrepancies and preserve chain-of-custody.
  • Structured evidence registry and automated reporting to produce a ready-to-share forensic narrative.

Quick Start

Start a new investigation by running the OSS Forensics workflow against the target repository.

Frequently Asked Questions about oss-forensics

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

FAQPage Schema
How do I investigate open-source supply-chain attacks on GitHub repositories?

To investigate supply-chain attacks on GitHub repositories, you can run a phase-based workflow that aggregates evidence from the GitHub API, GH Archive, Wayback Machine, and local git history. This process preserves artifacts and correlates discrepancies to form defensible conclusions.

What is open-source supply-chain forensics and when do I need it?

Open-source supply-chain forensics is the structured collection and cross-source verification of evidence to identify compromises in repositories. You need it when investigating suspicious commits, malicious package injections, or deleted artifacts that obscure evidence on GitHub.

Can I recover evidence from deleted GitHub commits and repository changes?

Yes, you can recover evidence from deleted GitHub commits by querying historical data sources like the GH Archive and the Wayback Machine. Cross-referencing these sources with local git history helps identify discrepancies and preserve artifacts that were removed.

What's the best way to preserve chain-of-custody for a GitHub repository investigation?

The best way to preserve chain-of-custody is using a structured evidence registry that consolidates data from multiple sources into an evidence.json file. This enforces safe data handling and detailed documentation for reproducible forensic outcomes.

Does this GitHub forensics workflow require local git history to work?

No, while local git history is one of the aggregated sources, the workflow also collects data from the GitHub API, GH Archive, and Wayback Machine. Cross-source verification means investigations can proceed even if local history is incomplete.

How do I generate a reproducible forensic report for a compromised open-source project?

You generate a reproducible forensic report by completing an investigation workflow that initializes, collects data, consolidates evidence, validates hypotheses, and outputs a detailed investigation report alongside an evidence registry for responsible disclosure.