oss-forensics

Reconstruct GitHub repository compromise timelines from git, API, and archive sources.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/JKhyro/HERMES-AGENT --skill oss-forensics-jkhyro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oss-forensics
Source: https://github.com/JKhyro/HERMES-AGENT/tree/main/optional-skills/security/oss-forensics
Command: npx skills add https://github.com/JKhyro/HERMES-AGENT --skill oss-forensics-jkhyro

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps you investigate whether a GitHub repository has been compromised, tampered with, or rewritten to hide suspicious activity, while keeping every conclusion anchored to evidence.

Core Features & Use Cases

  • Repository Forensics: Reconstruct commit history, detect force-pushes, and identify dangling or deleted changes in local git data.
  • Multi-Source Correlation: Cross-check GitHub API data, GitHub Archive events, and Wayback snapshots to spot deletions, rewrites, and permission changes.
  • IOC Handling and Reporting: Extract indicators of compromise, enrich them from passive public sources, validate hypotheses, and generate a structured forensic report.
  • Use Case: Investigate a suspicious open-source repository after a maintainer account anomaly, recover erased commits, and produce an evidence-backed timeline for responders.

Quick Start

Ask this Skill to investigate a GitHub repository for compromise indicators, recover deleted history, and produce an evidence-backed 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 a GitHub repository for a force-push history rewrite?

You can investigate a force-push history rewrite by reconstructing commit history and cross-checking local git data with GitHub Archive events to identify dangling commits. This recovers deleted changes and produces an evidence-backed forensic timeline.

What is the best way to recover deleted commits after a supply chain compromise?

Recovering deleted commits after a supply chain compromise involves correlating Wayback Machine snapshots and GitHub API data to spot deletions. Multi-source verification anchors recovery efforts to verified evidence and reconstructs the timeline.

Can I extract indicators of compromise from suspicious GitHub releases?

Yes, you can extract indicators of compromise from suspicious GitHub releases and CI/CD abuse. The process enriches IOCs from passive public sources, validates hypotheses against multi-source data, and outputs a structured forensic report.

Does this forensic investigation method require access to the Wayback Machine and GitHub Archive?

Yes, multi-source correlation requires access to the Wayback Machine and GitHub Archive to spot deleted PRs and permission changes. These sources cross-check local git and GitHub API data to validate hypotheses and reconstruct an evidence-backed timeline.

How do I validate hypotheses when investigating deleted pull requests and issues?

You validate hypotheses when investigating deleted pull requests and issues by cross-referencing GitHub API data with Wayback snapshots and GitHub Archive events. Multi-source verification anchors conclusions to evidence within a forensic report with integrity checks.

What are the limitations of reconstructing git history using only local data?

Reconstructing git history using only local data limits visibility into deleted PRs and permission changes. Multi-source correlation across GitHub API, GitHub Archive, and Wayback Machine is required to detect erased commits and generate a complete structured forensic report.