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.