oss-forensics

Analyze GitHub repositories for supply chain attacks using multi-source evidence.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, jq, gcloud, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill addresses the complexity of investigating open-source supply chain compromises by providing a structured, evidence-based framework to recover deleted data and validate security hypotheses.

Core Features & Use Cases

  • Multi-Source Evidence Collection: Aggregates data from local git repositories, GitHub API, GitHub Archive (BigQuery), and the Wayback Machine.
  • Forensic Reporting: Generates structured, evidence-backed reports with clear timelines and Indicators of Compromise (IOCs).
  • Use Case: If a repository is suspected of a supply chain attack involving force-pushed commits to hide malicious code, this Skill can recover the deleted commit SHAs and verify the timeline of the injection.

Quick Start

Use the oss-forensics skill to investigate the repository owner/repo for potential supply chain compromise.

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 supply chain attacks?

To investigate GitHub repositories for supply chain attacks, you need a structured forensic framework that recovers deleted commits, detects force-pushes, and validates unauthorized CI/CD modifications using a rigorous 7-phase validation process.

Can I recover deleted git commits hidden by force-pushes?

Yes, you can recover deleted git commits hidden by force-pushes by aggregating multi-source evidence from local git repositories, the GitHub API, GitHub Archive on BigQuery, and the Wayback Machine to reconstruct the hidden commit SHAs.

What is multi-source evidence collection in open-source forensics?

Multi-source evidence collection in open-source forensics aggregates data from local git repositories, GitHub API, GitHub Archive via BigQuery, and the Wayback Machine to verify supply chain compromises and validate security hypotheses.

Do I need Python3 and gcloud to perform forensic analysis on GitHub repositories?

Yes, you need Python3, gcloud, and jq installed to perform forensic analysis on GitHub repositories, as these dependencies are required to query the GitHub API and access the GitHub Archive on BigQuery.

How does forensic reporting document indicators of compromise for open-source software?

Forensic reporting documents indicators of compromise for open-source software by generating structured, evidence-backed reports that establish clear timelines of malicious code injection using cross-referenced data.

What's the best way to detect unauthorized CI/CD modifications in a compromised repository?

The best way to detect unauthorized CI/CD modifications in a compromised repository is applying a rigorous 7-phase validation framework that cross-references local git data with GitHub API evidence.