One-click install
npx skills add https://github.com/Signmanal/VIGIL --skill oss-forensics-signmanal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oss-forensics
Source: https://github.com/Signmanal/VIGIL/tree/main/optional-skills/security/oss-forensics
Command: npx skills add https://github.com/Signmanal/VIGIL --skill oss-forensics-signmanal

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill solves the complex, time-sensitive problem of investigating suspected open source software supply chain attacks, where critical evidence may be deleted, hidden via force-pushes, or scattered across multiple archival and API sources.

Core Features & Use Cases

  • 7-Phase Multi-Agent Investigation Framework: Orchestrates specialized sub-agents to collect, cross-reference, and validate evidence without mixing data sources, ensuring investigation integrity.
  • Multi-Source Evidence Recovery: Pulls data from local git repositories, GitHub REST API, Wayback Machine archives, and GitHub Archive BigQuery to recover deleted commits, issues, PRs, and hidden repository changes.
  • Structured Forensic Reporting: Generates evidence-backed, citation-mandated reports with validated hypotheses, full IOC lists, and chain of custody for responsible vulnerability disclosure.
  • Use Case: If you suspect a critical open source library was compromised via a malicious maintainer commit, use this Skill to recover force-pushed evidence, validate attack hypotheses, and produce a report for coordinated disclosure with maintainers and package registries.

Quick Start

Use the oss-forensics skill to investigate the repository owner/repo for signs of supply chain compromise, recover any deleted commit evidence, and generate a full forensic report with validated findings.

Frequently Asked Questions about oss-forensics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I recover force-pushed commits after a GitHub repository compromise?

Recover force-pushed commits by pulling data from local git repositories, the GitHub REST API, Wayback Machine archives, and GitHub Archive BigQuery to reconstruct deleted repository changes and validate supply chain attack hypotheses.

How does open source supply chain forensics work for malicious dependency injection analysis?

Open source supply chain forensics works by orchestrating specialized sub-agents to collect, cross-reference, and validate evidence without mixing data sources, ensuring investigation integrity for malicious dependency injection analysis.

What is the best way to extract indicators of compromise from a suspected compromised maintainer account?

The best way to extract indicators of compromise is through a multi-source investigation framework that cross-references local git data, GitHub APIs, and archive sources to detect maintainer account compromise and generate validated IOC lists.

Can I reconstruct deleted issues and pull requests for a coordinated vulnerability disclosure report?

Yes, you can reconstruct deleted issues and pull requests by querying the GitHub REST API and GitHub Archive BigQuery, generating structured forensic reports with chain of custody tracking for coordinated vulnerability disclosure.

Does open source supply chain forensics support evidence-backed hypothesis validation from multiple archival sources?

Yes, open source supply chain forensics supports evidence-backed hypothesis validation by cross-referencing multi-source data from the Wayback Machine, GitHub Archive BigQuery, and local git repositories to ensure validated findings.

When should I use a multi-phase forensic investigation framework for GitHub security incidents?

Use a multi-phase forensic investigation framework when you suspect a critical open source library was compromised via a malicious maintainer commit, requiring evidence recovery, attack hypothesis validation, and structured reporting for coordinated disclosure.