oss-forensics

Correlate evidence from GitHub, web archives, and CI/CD data to investigate supply chain security incidents.

Updated May 3, 2026
One-click install
npx skills add https://github.com/Yangel-hide/video-production-planner-agent --skill oss-forensics-yangel-hide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oss-forensics
Source: https://github.com/Yangel-hide/video-production-planner-agent/tree/main/optional-skills/security/oss-forensics
Command: npx skills add https://github.com/Yangel-hide/video-production-planner-agent --skill oss-forensics-yangel-hide

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

OSS Forensics provides a structured, multi-phase framework to investigate open-source supply chain attacks by collecting and correlating evidence from multiple sources and generating formal forensic reports.

Core Features & Use Cases

  • A 7-phase, multi-agent investigation framework for researching open-source supply chain attacks.
  • Integrates GitHub Archive (BigQuery), Wayback Machine, GitHub API, local Git analysis, IOC extraction, evidence-backed hypothesis formation, and final forensic reporting.
  • Built-in anti-hallucination guardrails, evidence-first validation, and cross-source verification to ensure credible findings.
  • Phase-driven workflow (Phase 0 to Phase 7) guiding initialization, evidence collection, hypothesis validation, and final report generation with a reusable evidence store.
  • Supports responsible disclosure workflows and template-based final reports.

Quick Start

Initialize an investigation directory, gather evidence using the evidence-store tool, and generate the forensic report template for your 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 deleted content and force-push events in open-source supply chain security incidents?

To investigate supply chain security incidents, collect and correlate evidence from GitHub API, local Git analysis, and web archives. This framework analyzes force-push events and deleted content by applying cross-source verification to build credible forensic reports.

What is the best way to extract IOCs from a compromised GitHub repository?

The best way to extract IOCs from a compromised repository is using a structured phase-driven workflow. This framework applies evidence-first validation across GitHub Archive, Wayback Machine, and CI/CD data to identify indicators of compromise while preventing hallucinated findings.

How do I generate a forensic report for an open-source supply chain attack?

Generate a forensic report by completing the multi-phase investigation workflow and populating a reusable evidence store. The framework normalizes collected evidence, forms evidence-backed hypotheses, and outputs a structured final report template suitable for responsible disclosure.

Can I use GitHub Archive and Wayback Machine data together for cross-source verification?

Yes, you can use GitHub Archive and Wayback Machine data together for cross-source verification. The framework integrates BigQuery, web archives, and local Git analysis to correlate evidence across multiple sources, ensuring credible findings for supply chain attacks.

Does the OSS forensics investigation framework require external dependencies?

The OSS forensics investigation framework operates without external dependencies. It orchestrates evidence collection and hypothesis validation through built-in scripts and reference components, guiding users from initialization through final report generation.

How do I start an open-source repository investigation when I suspect a supply chain attack?

Start an open-source repository investigation by initializing an investigation directory and gathering evidence using the evidence-store tool. The framework's Phase 0 initialization sets up the environment before progressing through evidence collection and hypothesis validation.