oss-forensics

Investigate GitHub supply-chain attacks by collecting evidence and extracting IOCs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, git, curl, jq, gcloud, bq, base64, hashlib, and includes scripts (resource) and references (resource) components.

What problem does it solve?

It helps you investigate suspected open-source supply-chain compromises by reconstructing what happened in a GitHub repository and producing an evidence-backed forensic report.

Core Features & Use Cases

  • Evidence-first OSS forensics: A structured, multi-phase workflow focused on collecting and validating concrete indicators (commits, actors, files, and events) before making claims.
  • Deleted/erased activity recovery: Uses local git analysis, GitHub API, Wayback Machine, and GitHub Archive (BigQuery) to recover or corroborate force-push and deletion indicators.
  • IOC-focused investigation: Extracts and enriches IOCs (e.g., commit SHAs, workflow files, actor accounts, suspicious paths, secrets indicators) and consolidates them into a final report with a clear chain of custody.

Quick Start

Tell the agent: investigate owner/repo for supply-chain compromise and recover any deleted commits, force-push evidence, and IOCs, then generate a structured 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 suspected open-source supply-chain attack in a GitHub repository?▼

To investigate an open-source supply-chain attack, you need to collect cross-source evidence, extract indicators of compromise (IOCs), and validate hypotheses regarding deleted commits, force-push cover-ups, or workflow injections before generating a structured forensic report.

Can I recover deleted commits or force-push evidence from GitHub?▼

Yes, you can recover deleted commits or force-push evidence by correlating local git analysis with the GitHub API, Wayback Machine snapshots, and GitHub Archive BigQuery data to reconstruct erased repository activity and establish a chain of custody.

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

The best way to extract IOCs from a compromised GitHub repository is to apply an evidence-first investigation workflow that identifies suspicious commit SHAs, malicious workflow files, and compromised actor accounts, consolidating them into a final validated report.

Do I need Python and Google Cloud CLI to perform OSS forensics on GitHub repositories?▼

Yes, performing advanced OSS forensics typically requires Python3, git, curl, jq, and Google Cloud CLI components like gcloud and bq to query the GitHub Archive on BigQuery and validate multi-source evidence boundaries.

How does evidence validation work when investigating maintainer takeover signals?▼

Evidence validation for maintainer takeover signals works by enforcing multi-source boundaries per sub-agent investigation, requiring concrete citations for every claim, and assigning verified Evidence IDs before finalizing the incident reporting output.

What are the limitations of reconstructing CI/CD workflow injection attacks?▼

Reconstructing CI/CD workflow injection attacks is limited by the availability of historical data from sources like the Wayback Machine and GitHub Archive, as maliciously injected workflow files or force-pushed commits may be permanently erased from the primary repository.