oss-forensics

Correlate OSS supply chain indicators from git, GitHub, and external IOC sources.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Supply chain investigation, evidence recovery, and forensic analysis for GitHub repositories. This skill provides a structured framework to uncover, collect, and validate evidence across multiple data sources to determine if a repository has been compromised or involved in a supply chain attack.

Core Features & Use Cases

  • Multi-source evidence collection and cross-source correlation (Git, GitHub API, GH Archive, Wayback Machine, IOC enrichment) to surface credible conclusions.
  • Phase-based investigation workflow with guardrails to prevent hallucinations, and a formal evidence registry for traceability.
  • Automated report generation that synthesizes findings into a forensic-style narrative with citations and redactions.

Quick Start

Initiate an OSS forensics investigation to create an investigation workspace, collect evidence from multiple sources, and generate a final 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 a supply chain attack?

To investigate a GitHub repository for a supply chain attack, you can use a seven-phase forensic workflow that aggregates local git data, GitHub API, and Wayback Machine snapshots to validate evidence and detect compromises. The process enforces guardrails to prevent hallucinations and maintains a formal evidence registry for traceability.

What is OSS supply chain forensics and when do I need it?

OSS supply chain forensics is the structured process of uncovering, collecting, and validating evidence across multiple data sources to determine if a repository has been compromised. You need it when you suspect a supply chain attack or require formal evidence recovery for a GitHub repository.

Can I collect forensic evidence from the Wayback Machine and GH Archive for a GitHub repo?

Yes, you can collect forensic evidence from the Wayback Machine and GitHub Archive. The investigation aggregates data from these external sources alongside local git data and the GitHub REST API to cross-correlate supply chain indicators and surface credible conclusions.

What's the best way to generate a forensic report with cross-source citations for a compromised repo?

The best way to generate a forensic report for a compromised repo is using an automated workflow that synthesizes multi-source evidence into a structured narrative. The final report includes cross-source citations, redacted secrets, and validated hypotheses consolidated by specialized sub-agents.

How do I prevent hallucinations during an open source security investigation?

To prevent hallucinations during an open source security investigation, the forensic workflow enforces strict guardrails and spawns specialized sub-agents to validate hypotheses. It maintains a verifiable evidence registry that ensures all findings are traceable across local git, API, and archived data sources.

Does an OSS forensic investigation require external IOC sources to validate findings?

An OSS forensic investigation uses external IOC sources to enrich and validate findings. It correlates these indicators of compromise with data gathered from local git, the GitHub REST API, GitHub Archive, and the Wayback Machine to ensure cross-source validation before consolidating the final report.