oss-forensics

Performs forensic analysis of container images and discovers CVEs and hidden content.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, beautifulsoup4, python-dateutil, python-docx, python-multipart, python-requests, pandas, google-cloud-bigquery, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill provides a comprehensive, 7-phase investigation framework for researching open-source supply chain attacks, covering deleted commit recovery, IOC extraction, and structured forensic reporting.

Core Features & Use Cases

  • Multi-Agent Framework: Concurrent investigation across GitHub Archive, local git, Wayback Machine, GitHub API, and IOC enrichment.
  • Deleted Commit Recovery: Utilizes GitHub Archive and Git recovery techniques to find force-pushed or deleted commits.
  • IOC Extraction and Enrichment: Extracts indicators of compromise and enriches them using various public sources.
  • Hypothesis Formation and Validation: Mechanically validates hypotheses based on evidence and logical consistency.
  • Structured Reporting: Generates a detailed forensic report with evidence registry, timeline, hypotheses, and recommendations.

Quick Start

To start a new investigation, run: hermes run security:oss-forensics --repository [repository_owner/repo_name]

Frequently Asked Questions about oss-forensics

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

FAQPage Schema
How do I recover deleted commits after a force push on GitHub?

To recover deleted commits after a force push on GitHub, this Skill utilizes GitHub Archive and local git recovery techniques to find force-pushed or removed commit history. It extracts missing data for in-depth supply chain investigation.

How does IOC extraction work for open-source repository investigation?

IOC extraction for open-source repository investigation works by pulling indicators of compromise from local git analysis, GitHub API calls, and Wayback Machine queries. These indicators are then enriched using various public sources for structured reporting.

Do I need BigQuery access to investigate GitHub repository supply chain attacks?

Yes, you need BigQuery access to comprehensively investigate GitHub repository supply chain attacks. The forensic framework requires BigQuery alongside GitHub API, local git repository access, and Wayback Machine queries to detect deleted commits and extract IOCs.

What is the best way to analyze suspicious open-source repositories for security threats?

The best way to analyze suspicious open-source repositories is using a multi-agent framework that runs concurrent investigations across GitHub Archive, local git, and Wayback Machine. This approach mechanically validates hypotheses and generates structured forensic reports.

Can I generate a structured forensic report from GitHub repository analysis?

Yes, you can generate a structured forensic report from GitHub repository analysis. The framework produces detailed documentation featuring an evidence registry, timeline, hypotheses, and recommendations based on a comprehensive 7-phase investigation.

Why does Wayback Machine web archive querying matter for supply chain security?

Wayback Machine web archive querying matters for supply chain security because it captures historical repository states before malicious force-pushes or deletions occur. Comparing archived data against current local git states reveals hidden tampering and security anomalies.