oss-forensics-agent

Detect and analyze supply-chain compromise indicators in GitHub repositories.

3|1|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/camgrimsec/grimsec-suite --skill oss-forensics-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oss-forensics-agent
Source: https://github.com/camgrimsec/grimsec-suite/tree/main/agents/11-oss-forensics-agent
Command: npx skills add https://github.com/camgrimsec/grimsec-suite --skill oss-forensics-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Organizations need an evidence‑backed method to investigate open‑source repositories for supply‑chain attacks, suspicious commits, and compromised maintainers.

Core Features & Use Cases

  • Collects comprehensive data from GitHub APIs, GH Archive, Wayback Machine, and package registries.
  • Extracts indicators of compromise, reconstructs event timelines, and forms hypothesis reports.
  • Generates detailed forensic reports for executive escalation or further threat‑intel monitoring.

Quick Start

Ask the oss-forensics skill to investigate a repository URL for suspicious activity.

Frequently Asked Questions about oss-forensics-agent

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

FAQPage Schema
How do I investigate a GitHub repository for a supply-chain compromise?

Investigate a GitHub repository for a supply-chain compromise by analyzing suspicious commits, collaborator changes, and CI pipeline modifications to extract IOCs and reconstruct event timelines for forensic reporting.

What is the best way to detect indicators of compromise in open-source projects?

Detect indicators of compromise in open-source projects by collecting data from GitHub APIs, GH Archive, Wayback Machine, and package registries to identify suspicious commits and compromised maintainers.

Can I generate a forensic timeline of suspicious commits using GitHub APIs and the Wayback Machine?

Yes, you can generate a forensic timeline by collecting repository evidence from GitHub APIs and Wayback Machine, extracting IOCs from suspicious commits, and reconstructing event timelines for threat-intel monitoring.

Do I need GitHub API access to perform open-source forensics on a repository?

Yes, GitHub API access is required to collect comprehensive evidence for open-source forensics, and optional repository cloning is supported to extract additional indicators of compromise.

How does CI pipeline modification analysis help detect compromised maintainers?

CI pipeline modification analysis helps detect compromised maintainers by identifying unauthorized changes to continuous integration configurations, reconstructing event timelines, and generating detailed forensic reports for executive escalation.

What limitations exist when investigating package registries for supply-chain attacks?

Investigating package registries for supply-chain attacks relies on available historical data from GH Archive and Wayback Machine, meaning investigations may be limited if repositories or package registries lack comprehensive public logs.