agentleFS
mindfortaimindfortai/security-skills/skills/finding-review/SKILL.md

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.

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
  1. Distinctive:

    Use this skill to assess defensive cybersecurity findings.

    line 9
  2. Very specific:

    Use status values such as valid, likely_valid, under_evidenced, duplicate, informational, likely_false_positive, or false_positive.

    line 28
  3. Distinctive:

    Put a short explanation, missing evidence, and validation notes after the CSV unless the user asks for CSV only.

    line 39
  4. Distinctive:

    Do not invent exploitability.

    line 43
  5. Distinctive:

    Do not treat scanner labels as authoritative.

    line 44
  6. Distinctive:

    Do not provide payloads, bypass chains, persistence guidance, or destructive exploitation steps.

    line 45
  7. Distinctive:

    Prefer defensive validation steps that a system owner can run safely.

    line 46
  8. Very specific:

    When the target code or local test environment is available, run a safe smoke test or source-level validation before marking a finding …

    line 47
  9. Distinctive:

    Use temporary stubs only for unavailable external services, credentials, or nondeterministic dependencies.

    line 48
  10. Distinctive:

    When subagents are available, ask an independent subagent to challenge high-impact verdicts for evidence quality, duplicate status, …

    line 50

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Finding Review

Use this skill to assess defensive cybersecurity findings. Prioritize evidence quality and reproducibility over generic severity labels.

Workflow

  1. Identify the claim, affected asset, affected user role, and security boundary.
  2. Separate observed evidence from inference.
  3. Determine whether the finding is valid, false positive, duplicate, informational, or under-evidenced.
  4. Assess exploitability from the attacker's realistic starting permissions and network position.
  5. Assess impact in business and technical terms.
  6. 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_notes

Use 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 valid or false_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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.