oss-forensics

Investigate GitHub repositories for supply-chain compromises across a 7-phase workflow.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Supply chain investigation, evidence recovery, and forensic analysis for GitHub repositories. Covers deleted commit recovery, force-push detection, IOC extraction, multi-source evidence collection, hypothesis formation/validation, and structured forensic reporting. Inspired by RAPTOR's OSS Forensics system.

Core Features & Use Cases

  • A 7-phase multi-agent investigation framework for researching open-source supply chain attacks.
  • Integrates data from Git history, GitHub API, Wayback Machine archives, and evidence-enrichment to produce a defendable, evidence-backed report.
  • Built-in guardrails to enforce evidence integrity and prevent hallucinations during analysis.

Quick Start

Initiate a full-scale OSS forensic investigation on a target repository and generate a formal report with evidence and IOCs.

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 compromise?

To investigate a GitHub repository for a supply chain compromise, initiate a structured 7-phase forensic workflow that collects evidence from git data, GitHub APIs, and Wayback Machine archives to validate breach hypotheses.

Can I recover deleted commits and detect force-pushes during an OSS forensic investigation?

Yes, OSS forensic investigation supports deleted commit recovery and force-push detection by extracting local git history evidence and correlating it with multi-source data to trace supply-chain attack vectors.

How does evidence integrity work when extracting IOCs from open-source repositories?

Evidence integrity during IOC extraction is maintained through built-in guardrails that enforce multi-source verification across local git data, GitHub API, and Wayback Machine archives, preventing hallucinations and producing defendable reports.

What is the best way to generate a forensic report for a compromised open-source package?

The best way to generate a forensic report for a compromised open-source package is to use a structured investigation framework that formalizes evidence collection, hypothesis validation, and IOC enrichment into a single defendable output.

Do I need access to the GitHub API to investigate supply-chain incidents?

Yes, GitHub API access is required to perform end-to-end supply-chain forensics, as the investigation aggregates repository metadata, commit history, and Wayback Machine archives to verify evidence and validate attack hypotheses.

What are the limitations of using git history analysis for supply-chain attack investigations?

Git history analysis alone is limited in supply-chain attack investigations, requiring multi-source evidence enrichment from the Wayback Machine and GitHub API to validate hypotheses and prevent analytical hallucinations.