oss-forensics

Correlate git history, GitHub API, GH Archive, and Wayback evidence into forensic reports.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

OSS forensics helps you determine whether a GitHub repository has been compromised and reconstruct what happened, using evidence-backed analysis instead of guesswork.

Core Features & Use Cases

  • Multi-source evidence collection: Correlates local git analysis, GitHub REST API data, GH Archive/BigQuery event records, and Wayback Machine snapshots.
  • Force-push and deleted-content recovery: Identifies rewritten history indicators, extracts deleted commit evidence paths, and recovers archived pages when available.
  • IOC extraction and structured reporting: Builds an indicator list (commits, paths, actors, secrets, workflow artifacts) and outputs a forensic report with an evidence registry and chain of custody.

Quick Start

Ask the agent to investigate this repository for possible supply chain compromise and request a forensic report with recovered indicators and evidence-backed hypotheses.

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 a supply chain attack?

To investigate a GitHub repository for a supply chain attack, you reconstruct the incident by collecting and correlating verifiable evidence across local git history, GitHub API data, GH Archive events, and Wayback Machine snapshots to form validated hypotheses.

What is force-push detection in open-source forensics?

Force-push detection in open-source forensics identifies rewritten git history to uncover erased commits during a repository supply chain attack, extracting deleted commit evidence paths and recovering archived pages when available.

How do I extract Indicators of Compromise from a compromised GitHub repository?

To extract Indicators of Compromise from a compromised GitHub repository, you build an indicator list including malicious commits, paths, actors, secrets, and workflow artifacts, culminating in a structured forensic report with an evidence registry.

Does oss-forensics work with deleted GitHub PRs and issues?

Yes, oss-forensics works with deleted GitHub PRs and issues by recovering deleted content through GitHub REST API data, GH Archive/BigQuery event records, and Wayback Machine snapshots to reconstruct the attack timeline.

How do I validate evidence integrity during a git history investigation?

You validate evidence integrity during a git history investigation by enforcing an evidence-first workflow with EV-ID citations and performing evidence-store SHA integrity checks to ensure all recovered artifacts remain untampered.

What is the best way to generate a forensic report for a repository supply chain compromise?

The best way to generate a forensic report for a repository supply chain compromise is correlating multi-source evidence with validated hypothesis gating, producing a structured report containing the chain of custody and recovered indicators.