vet-untrusted-project

Statically audit unfamiliar repositories for weaponization against developers and coding agents.

Updated Sep 1, 2026
One-click install
npx skills add https://github.com/kevinhwang/.agents --skill vet-untrusted-project-kevinhwang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vet-untrusted-project
Source: https://github.com/kevinhwang/.agents/tree/main/skills/vet-untrusted-project
Command: npx skills add https://github.com/kevinhwang/.agents --skill vet-untrusted-project-kevinhwang

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Opening a cloned or downloaded project in an IDE, agent, or package manager can silently execute attacker-controlled code through hooks, MCP servers, lifecycle scripts, or compromised dependencies. This Skill performs a read-only static audit to classify whether a repository is weaponized before you trust, install, build, or run it. ## Core Features & Use Cases - Bounded hostile-repository audit: Reviews agent instructions, Git hooks, IDE tasks, package lifecycle scripts, and CI paths for concealed execution, prompt injection, credential theft, and persistence. - Dependency compromise screening: Parses existing lockfiles as inert data and batch-checks public package identities against OSV and GitHub malware advisories without invoking package managers. - Strict safety contract: Never executes target code, never writes to the target, and issues a verdict of NO_HOSTILE_INDICATORS, SUSPICIOUS, HOSTILE, or INCONCLUSIVE with evidence-backed findings. - Use Case: Before opening a GitHub project you just cloned, run this audit to confirm its hooks, configs, and dependencies contain no credible attack chain against your workstation or coding agent. ## Quick Start Audit the cloned repository at ~/Downloads/some-project for signs it is weaponized against developers or coding agents before I open it.

Frequently Asked Questions about vet-untrusted-project

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

FAQPage Schema
How do I check if a cloned repository is safe to open?

Run a read-only static audit that inspects agent instructions, Git hooks, IDE tasks, package lifecycle scripts, and dependency lockfiles for concealed execution or compromise. This Skill classifies the repository as NO_HOSTILE_INDICATORS, SUSPICIOUS, HOSTILE, or INCONCLUSIVE without executing any target code.

How to detect malicious dependencies in package-lock.json or yarn.lock?

Parse lockfiles as inert data and batch-query the OSV and GitHub malware advisory APIs with validated package names and versions. The included helper script does this without invoking package managers, retaining only MAL-* records and malware-classified advisories.

Does this audit check for application security vulnerabilities?

No. It is a maliciousness classifier, not an application-security, code-quality, privacy, or hardening review. Ordinary CVEs, insecure defaults, and missing dependency pins are explicitly out of scope unless tied to a weaponization chain.

Can the audit run builds or tests to verify behavior?

No. The safety contract forbids executing any target-controlled code, including builds, tests, package managers, hooks, and language servers. All inspection is static and read-only; dynamic detonation is a separate user-approved workflow.

What are the limitations of a static repository audit?

Static inspection cannot prove absence of malicious behavior, so a clean baseline yields medium confidence rather than a safety certification. If important surfaces are unreadable or too large to sample, the verdict is INCONCLUSIVE and the folder should stay isolated.