oss-forensics

Aggregate evidence from git history, GitHub API, and archives into structured incident reports.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This criteria-based framework provides a structured approach to investigating open-source supply chain incidents, enabling repeatable evidence collection, hypothesis testing, and defensible reporting.

Core Features & Use Cases

  • Phase-based investigative workflow covering initialization, evidence gathering, cross-source correlation, hypothesis validation, and final reporting.
  • Multi-source data collection (Git history, GitHub API, GH Archive, Wayback Machine) with an auditable evidence store and chain-of-custody.
  • Safe, policy-driven analysis guided by anti-hallucination guardrails and reproducible templates for reporting.

Quick Start

Launch an investigation against a target repository to collect evidence, validate hypotheses, and produce a formal 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 an open-source supply-chain attack?

Investigating an OSS supply-chain incident involves aggregating data from local git history, GitHub REST API, archival sources, and evidence store records. This framework applies a phase-based workflow from evidence collection to hypothesis validation, producing a structured forensic report.

What is the best way to collect git forensics evidence for incident response?

Collecting git forensics evidence requires aggregating local commit history with GitHub API data and archival sources like the Wayback Machine. This framework enforces multi-source correlation and an auditable chain-of-custody to ensure defensible incident response conclusions.

How does hypothesis validation work in supply-chain forensics?

Hypothesis validation in supply-chain forensics works by correlating multi-source evidence against investigative criteria. The framework applies anti-hallucination guardrails during cross-source data analysis to test assumptions and generate defensible conclusions in the final reporting phase.

Do I need a Python runtime and GitHub access for OSS security investigations?

Yes, you need a Python runtime and GitHub access for OSS security investigations. The workflow requires accessing the GitHub REST API and BigQuery as needed, while supporting delegated sub-investigators to manage multi-source evidence collection and correlation.

Can I use archival sources like the Wayback Machine for incident response forensics?

Yes, you can use archival sources like the Wayback Machine and GH Archive for incident response forensics. The framework integrates these external sources with local git history and GitHub API data to perform cross-source correlation and validate supply-chain attack hypotheses.

What are the limitations of criteria-based supply-chain incident reporting?

Limitations of criteria-based supply-chain incident reporting include dependence on external API access to GitHub and BigQuery, requiring a Python runtime, and strict anti-hallucination guardrails that may constrain rapid ad-hoc analysis outside the structured phase-based workflow.