finding-review
Skill16 starsChanged 5 months agoMITView on GitHub
Triages cybersecurity findings for validity, exploitability, impact, and evidence quality. Use when reviewing vulnerability reports, scanner output, pentest findings, or bug bounty submissions.
In this repository14 other files it gives its agents.
- access-reviewSkill
- agent-security-reviewSkill
- api-testingSkill
- branch-reviewSkill
- code-qualitySkill
- code-reviewSkill
- compliance-reviewSkill
- deep-appsec-reviewSkill
- leadership-reportSkill
- pr-reviewSkill
- retestSkill
- security-testsSkill
- supply-chain-reviewSkill
- threat-modelSkill
The file
We split this skill into the rules it gives an agent
10 rules. About 0 are common, 8 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈8
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 9
Use this skill to assess defensive cybersecurity findings.
- Very specific: line 28
Use status values such as valid, likely_valid, under_evidenced, duplicate, informational, likely_false_positive, or false_positive.
- Distinctive: line 39
Put a short explanation, missing evidence, and validation notes after the CSV unless the user asks for CSV only.
- Distinctive: line 43
Do not invent exploitability.
- Distinctive: line 44
Do not treat scanner labels as authoritative.
- Distinctive: line 45
Do not provide payloads, bypass chains, persistence guidance, or destructive exploitation steps.
- Distinctive: line 46
Prefer defensive validation steps that a system owner can run safely.
- Very specific: line 47
When the target code or local test environment is available, run a safe smoke test or source-level validation before marking a finding …
- Distinctive: line 48
Use temporary stubs only for unavailable external services, credentials, or nondeterministic dependencies.
- Distinctive: line 50
When subagents are available, ask an independent subagent to challenge high-impact verdicts for evidence quality, duplicate status, …
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Finding Review
Use this skill to assess defensive cybersecurity findings. Prioritize evidence quality and reproducibility over generic severity labels.
Workflow
- Identify the claim, affected asset, affected user role, and security boundary.
- Separate observed evidence from inference.
- Determine whether the finding is valid, false positive, duplicate, informational, or under-evidenced.
- Assess exploitability from the attacker's realistic starting permissions and network position.
- Assess impact in business and technical terms.
- Recommend the smallest remediation that removes the vulnerability class.
Output Format
Output the triage result as CSV with this exact header:
id,severity,confidence,status,category,title,location,asset_or_flow,actor,issue,impact,evidence,fix,test,scope_notesUse status values such as valid, likely_valid, under_evidenced, duplicate, informational, likely_false_positive, or false_positive. Use category values from the finding class, such as authorization, authentication, injection, data-exposure, supply-chain, configuration, business-logic, or tests.
For reviewed findings, use:
issue: whether the original claim is supported and what security property would fail.impact: realistic technical and business impact if valid.evidence: observed evidence and whether it proves reachability.fix: smallest remediation for valid or likely-valid findings.test: safe validation or regression plan.scope_notes: missing evidence, duplicate reference, or false-positive rationale.
Put a short explanation, missing evidence, and validation notes after the CSV unless the user asks for CSV only.
Rules
- Do not invent exploitability. If evidence is missing, say exactly what evidence is needed.
- Do not treat scanner labels as authoritative.
- Do not provide payloads, bypass chains, persistence guidance, or destructive exploitation steps.
- Prefer defensive validation steps that a system owner can run safely.
- When the target code or local test environment is available, run a safe smoke test or source-level validation before marking a finding
validorfalse_positive. - Use temporary stubs only for unavailable external services, credentials, or nondeterministic dependencies. Do not stub the claimed vulnerable control or impacted path.
- Clean up temporary fixtures, scratch files, local config changes, and ad hoc validation scripts before final output.
- When subagents are available, ask an independent subagent to challenge high-impact verdicts for evidence quality, duplicate status, exploitability, and severity.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

