vuln-research

Find, reproduce, and report security vulnerabilities against a stated threat model.

64|11|Updated May 24, 2026
One-click install
npx skills add https://github.com/AlexanderMattTurner/agent-glovebox --skill vuln-research-alexandermattturner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vuln-research
Source: https://github.com/AlexanderMattTurner/agent-glovebox/tree/main/.claude/skills/vuln-research
Command: npx skills add https://github.com/AlexanderMattTurner/agent-glovebox --skill vuln-research-alexandermattturner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI-generated vulnerability reports are often unverified hypotheses that waste maintainer time and erode trust in security research. This Skill enforces a reproduce-before-report discipline so every finding you escalate is backed by a runnable command, scored against the project's actual threat model, and independently refuted before it leaves the session. ## Core Features & Use Cases - Threat-model scoring: Evaluates every candidate against the repo's SECURITY.md claims and out-of-scope list, so you only report breaks of claims the project actually makes. - Three-tier evidence standard: Classifies findings as a failing test, a live boundary transcript, or a code trace, and requires you to state which level you reached. - Tool corroboration: Routes checks through the scanners already wired into the tree (bandit, osv-scanner, grype, CodeQL, Stryker, Hypothesis) instead of re-deriving results by hand. - Independent refutation: Spawns a fresh sub-agent tasked with disproving the finding before escalation, and records its verdict in the report. - Bounded disclosure: Caps reports at 300 words per finding in a fixed five-part format, and routes all external disclosure through a human. - Use Case: A scanner flags a possible sandbox escape in the audit-log path. You reproduce it with a failing test, confirm it breaks a specific SECURITY.md claim, have a sub-agent attempt refutation, then hand the maintainer a concise report ready for a private advisory. ## Quick Start Ask the AI to audit this repository for security vulnerabilities and report only findings it can reproduce against the threat model in SECURITY.md.

Frequently Asked Questions about vuln-research

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

FAQPage Schema
How do I verify a security vulnerability before reporting it?

Reproduce it with a command that demonstrates the break, ranked from strongest to weakest: a failing test, a live boundary transcript, or a quoted code trace. State explicitly which evidence level you reached, and never report a finding you could not reproduce.

How do I write a good vulnerability report for an upstream maintainer?

Keep it under 300 words with five parts: the threat-model claim it breaks, the reproduction command and evidence level, the attacker impact in one sentence, the refuter's verdict, and a fix or reason none was written. Send it privately with working reproduction steps.

What tools should corroborate a suspected vulnerability?

Use the scanners already wired into the repo: bandit and ast-grep for pattern matches, osv-scanner and grype for known CVEs in dependencies and images, CodeQL for data-flow paths, and mutation testing plus Hypothesis fuzzing for test coverage gaps.

When is a security finding out of scope for a project?

A finding is out of scope when it lands in the project's declared exclusions, such as outside attackers, host compromise, or supply-chain issues, or when it restates a limitation already documented in SECURITY.md. Check the threat model first and dismiss those candidates in one line.

Why should a second AI agent review a vulnerability finding?

An independent sub-agent tasked with refuting the finding catches invented details, broken reasoning, and misread lines that self-review misses. It cannot catch shared misconceptions, so its verdict supplements but never replaces an actual reproduction.

Can an AI agent open a public security advisory itself?

No. Disclosure is outward-facing and irreversible, so the agent writes the report and marks it ready to send, but a human decides what goes outside through a private advisory channel. Never open public issues, CVE requests, or upstream reports autonomously.