agentleFS
abevzabevz/devops-skills/skills/vulnerability-triage/SKILL.md

vulnerability-triage

Skill0 starsChanged 41 days agoMITView on GitHub

Use when triaging vulnerability scanner findings — deciding what to fix now, what to defer, and what to suppress across SAST/SCA/image/IaC scanners. Mention "triage these CVEs", "scanner findings", "vulnerability backlog", "suppress this finding" as triggers.

7 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use 0-template, github-actions-builder and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • JayRHaSkill

    0-template

    Template for creating a new Agent Skill. Copy this folder, rename it to your skill's kebab-case name, and fill in every section. Use this as the starting point whenever you author a new skill for the AgentSkills library.

    Also in 3 projects that use this

  • JayRHaSkill

    github-actions-builder

    Builds reliable, fast, and secure GitHub Actions CI/CD workflows with dependency caching, build matrices, scoped secrets, concurrency control, and reusable/composite workflows. Use this skill when the user asks to "create a GitHub Actions workflow", "set up CI", "add CI/CD", "fix a flaky/slow GitHub Actions pipeline", "add a build matrix", "cache dependencies in CI", "write a reusable workflow", "configure deployment with environments and secrets", or mentions files under .github/workflows.

    Also in 3 projects that use this

  • xmqywxSkill

    meeting-summarizer

    Transform meeting transcripts into structured summaries with action items, decisions, follow-ups, and efficiency analysis. Works with any meeting format.

    Also in 3 projects that use this

  • MehdibargachSkill

    okr-writer

    Turn business goals into structured OKRs with measurable Key Results, linked initiatives, alignment check, and anti-goals. Takes a strategic priority and outputs ready-to-use OKRs.

    Also in 3 projects that use this

  • pbc-osSkill

    secrets-manager

    Set up and configure cloud secrets management for your AI agent. Guides users through platform selection (GCP, AWS, Azure, 1Password, Doppler, HashiCorp Vault), account setup, CLI configuration, and secure credential storage.

    Also in 3 projects that use this

  • +7 more from JayRHa

The file

We split this skill into the rules it gives an agent

7 rules. 0 are common, 6 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 7 edited versions we read keep these.

  • 6

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Read scanner output, package/image version, reachable code path, and exploit context.

    line 18
  2. Distinctive:

    Do not treat scanner severity alone as the remediation order.

    line 22
  3. Distinctive:

    Follow the Workflow, Safety rules, and Quality checklist below.

    line 26
  4. Very specific:

    Use when scanner output (trivy/grype/govulncheck/gosec/checkov/CodeQL/Dependabot or similar) needs decisions: prioritize, dedupe, fix, …

    line 36
  5. Distinctive:

    Never blanket-suppress by severity ("ignore all Mediums") or by file glob — suppressions are per-finding with individual justification.

    line 83
  6. Distinctive:

    Do not mark something false-positive without evidence (version check, reachability output, vendored-patch commit) — "probably fine" is a …

    line 85
  7. Distinctive:

    Do not auto-upgrade dependencies as part of triage — propose the upgrade.

    line 89

“Common” is measured: kept by at least 6 in 10 of the 7 edited versions of this file we could read. “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

Vulnerability Triage

TL;DR checklist

  • Dedupe scanner reports to the actual fix point.
  • Check runtime reachability, exploitability, and exposure.
  • Record fix, defer, or suppression with evidence and owner.

Key read-only checks

  • Read scanner output, package/image version, reachable code path, and exploit context.

Common pitfalls

  • Do not treat scanner severity alone as the remediation order.

Agent procedure

Follow the Workflow, Safety rules, and Quality checklist below.

Quick references

  • Workflow below.

Last verified: unverified

When to use

Use when scanner output (trivy/grype/govulncheck/gosec/checkov/CodeQL/Dependabot or similar) needs decisions: prioritize, dedupe, fix, defer, or suppress. This is the process skill that stops scanners from becoming ignored noise.

Goal

Turn raw findings into a short, ranked list of real actions — with every suppression justified and expiring, and nothing critical hiding in a wall of duplicates.

Workflow

  1. Dedupe first — the same CVE reported by 3 scanners across 5 images is one decision, not 15 findings. Group by (vulnerability, root component); the fix point is usually one base image bump or one dependency line.
  2. Reachability beats severity — a Critical in a library function the code never calls is below a Medium in the request path. Use reachability evidence where the ecosystem provides it (govulncheck call-graph analysis for Go is the model — it reports only vulnerabilities whose functions the code actually reaches); elsewhere approximate: is the vulnerable component loaded at runtime, or a build-time/test dependency?
  3. Prioritize on three axes — exploitability (is it in CISA KEV? high EPSS? public PoC?), exposure (internet-facing request path vs internal batch job), fix availability:

    SituationAction
    Exploitable (KEV/PoC) + exposed + fix existsFix now, out of band
    Exploitable + exposed, no fixCompensating control now (WAF rule, network policy, feature flag off) + track upstream
    Fix exists, not exposed / not reachableNormal backlog, batch with next dependency-update PR
    No fix, not reachableAccepted risk — documented, with re-check date
    Scanner wrong (version misdetect, vendored patch)False positive — suppress with evidence
  4. Fix at the root — prefer one base-image bump or one go get -u <module> over N per-image suppressions; check whether the fix is already waiting in an open Renovate/ Dependabot PR before creating work.
  5. Suppress with discipline — every suppression (.trivyignore, //nolint:gosec, #checkov:skip, VEX statement) carries: reason, evidence, owner, expiry. Suppression without expiry is silent permanent risk acceptance:
    # CVE-2026-12345 accepted until 2026-09-01 (owner: abevz)
    # reason: vulnerable function not reachable (govulncheck clean); vendor fix in v2.4
  6. One backlog — findings that survive triage land where work actually happens (issues/ Jira/Dependency-Track), not in per-scanner dashboards nobody owns. If the same finding gets re-triaged every sprint, the process — not the scanner — is broken.
  7. Close the loop — after fixing: re-scan to confirm, and check the expiring-suppressions list for anything past due while you're there.

Safety rules

  • Never blanket-suppress by severity ("ignore all Mediums") or by file glob — suppressions are per-finding with individual justification.
  • Do not mark something false-positive without evidence (version check, reachability output, vendored-patch commit) — "probably fine" is a deferral, not a false positive.
  • Accepted risk requires naming who accepted it and when it's re-evaluated — the agent proposes, a human accepts.
  • Do not auto-upgrade dependencies as part of triage — propose the upgrade; testing and merging it is a separate, reviewed change.

Output format

## Fix now (exploitable + exposed + fixable)
- <CVE/finding> — <root fix, one action even if N findings collapse into it>

## Compensating controls needed (no fix available)
## Backlog (batch into next update cycle)
## Accepted risk (proposed — needs human sign-off, with re-check date)
## False positives (with evidence)
## Suppressions past expiry

Quality checklist

  • Findings were deduped to root components before ranking
  • Reachability/exposure considered, not raw CVSS alone
  • Every suppression proposed has reason, evidence, owner, expiry
  • Root-cause fixes preferred over per-instance suppressions
  • Accepted-risk items are flagged for human sign-off, not silently accepted

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.