cve-exploitability-triage
Ranks known CVE findings by real-world exploitability instead of severity alone: enriches each CVE with its EPSS probability (the chance exploitation activity is observed in the next 30 days) and CISA KEV membership (confirmed exploited in the wild), applies OpenVEX status assertions to set aside vulnerabilities the product is not affected by, applies a reachability heuristic for vulnerable code that is never called, and assigns every finding to one of four buckets (Fix-Now, Fix-This-Sprint, Fix-Backlog, Accept-Risk) using documented EPSS thresholds. Treats a CISA KEV listing as non-waivable under any justification. Use when a dependency, container image, or SBOM vulnerability scan has produced more CVEs than the team can fix in the available window and someone has to decide which ones get fixed first and which can wait.
Install with skills.sh (any agent)
npx skills add testland/qa --skill cve-exploitability-triageCVE exploitability triage
A vulnerability scan returns a list. The list is almost always longer than the team's capacity to act on it, and sorting that list by CVSS severity produces a bad ordering: CVSS scores intrinsic technical severity, not the likelihood that anyone will actually attack you through it. The CVSS v3.1 specification says so directly, telling consumers to feed CVSS into "an organizational vulnerability management process that also considers factors that are not part of CVSS" (CVSS v3.1 specification (opens in new window)).
This skill supplies those other factors and turns them into an ordering. It takes a list of CVE findings that some scanning step has already produced, enriches each with exploitation signal, and emits a four-bucket priority assignment plus a report.
In scope: which CVEs matter, in what order, and why.
Out of scope: running scanners, parsing per-tool JSON into a common shape, deduplicating findings across tools, the waiver file format, and the CI pass/fail gate. Assume a preceding step handed over a normalized finding list.
The three signals, and what each one does not tell you
| Signal | Range | What it means | What it is not |
|---|---|---|---|
| CVSS base score | 0.0 to 10.0 | Intrinsic technical severity of the flaw | Not risk, not likelihood, not environment-aware |
| EPSS | 0 to 1 | Probability that exploitation activity is observed in the next 30 days | Not a severity score, not impact-aware |
| CISA KEV | boolean | The vulnerability has reliable evidence of active exploitation in the wild | Not exhaustive; absence is not evidence of safety |
CVSS v3.1 qualitative bands, used below wherever this skill says "critical" or "high" (CVSS v3.1 specification (opens in new window)):
| Rating | Base score |
|---|---|
| None | 0.0 |
| Low | 0.1 - 3.9 |
| Medium | 4.0 - 6.9 |
| High | 7.0 - 8.9 |
| Critical | 9.0 - 10.0 |
EPSS is the signal most often misread. FIRST defines it as "a daily estimate of the probability of exploitation activity being observed over the next 30 days" (EPSS model (opens in new window)). It is a forward-looking probability with a fixed 30-day horizon, not a rating of how bad the bug is. FIRST is explicit that EPSS "does not account for any specific environmental, nor compensating controls, nor does it make any attempt to estimate the impact of a vulnerability being exploited" (EPSS FAQ (opens in new window)). An EPSS of 0.90 on a low-severity information leak still describes a leak.
Each CVE also carries an EPSS percentile: "the proportion of all scored vulnerabilities with the same or a lower EPSS score" (EPSS data and statistics (opens in new window)). Probability and percentile answer different questions, and FIRST recommends reporting both together, since a probability of 0.10 already lands near the 88th percentile, which puts it in the top 12% of all scored CVEs (Understanding EPSS probabilities and percentiles (opens in new window)).
Step 1 - Establish the finding record
Triage needs six fields per finding. Where they came from does not matter.
interface TriageInput {
cve: string; // CVE-2021-44228, or GHSA-xxxx when no CVE was assigned
package: string; // ecosystem:name@version
severity: 'critical' | 'high' | 'medium' | 'low' | 'unknown';
cvss_base?: number; // 0.0 - 10.0
fix_version?: string; // absent means no fix is published yet
vex_status?: string; // populated in Step 4 if a VEX document exists
}Steps 2 through 5 add epss, epss_percentile, in_kev, kev_due_date, and reachable. Step 6 reads all of them and returns a bucket.
Findings with severity: unknown are treated as medium until a human sets them, so that an unscored CVE cannot silently fall into Accept-Risk.
Step 2 - Enrich with EPSS
Two access paths. Use the bulk CSV in CI (one download covers every CVE in the report) and the API for one-off lookups.
Bulk CSV. FIRST publishes a daily gzipped CSV of every scored CVE at https://epss.empiricalsecurity.com/epss_scores-current.csv.gz, with columns cve, epss, and percentile (EPSS data and statistics (opens in new window)):
curl -sSL https://epss.empiricalsecurity.com/epss_scores-current.csv.gz \
| gunzip > epss.csv
# Header lines start with '#'; the data header is cve,epss,percentile
grep '^CVE-2021-44228,' epss.csv
# CVE-2021-44228,0.94400,0.99950API. https://api.first.org/data/v1/epss accepts cve (comma separated, up to 2000 characters), date (YYYY-MM-DD, back to 2021-04-14), epss-gt, and percentile-gt (EPSS API (opens in new window)):
curl -sS "https://api.first.org/data/v1/epss?cve=CVE-2021-44228,CVE-2019-16759&pretty=true"The response data[] entries carry cve, epss, percentile, and date (EPSS API (opens in new window)).
Two operational rules:
Step 3 - Enrich with CISA KEV
CISA maintains the KEV catalog as "the authoritative source of vulnerabilities that have been exploited in the wild" (Reducing the significant risk of known exploited vulnerabilities (opens in new window)). A CVE is added only when all three thresholds are met, quoted from that page:
Criterion 2 is what makes KEV membership decisive. CISA defines active exploitation as reliable evidence that "execution of malicious code was performed by an actor on a system without permission of the system owner", and explicitly excludes scanning, security research, and the mere public availability of a proof of concept (same page). A KEV entry is therefore an observation, not a prediction.
Pull the JSON feed and join on cveID:
curl -sSL -o kev.json \
https://www.cisa.gov/sites/default/files/feeds/known_exploited_vulnerabilities.json
jq -r '.vulnerabilities[]
| select(.cveID == "CVE-2021-44228")
| {cveID, dateAdded, dueDate, knownRansomwareCampaignUse, requiredAction}' kev.jsonThe feed carries top-level title, catalogVersion, dateReleased, and count, and per-entry cveID, vendorProject, product, vulnerabilityName, dateAdded, shortDescription, requiredAction, dueDate, knownRansomwareCampaignUse, notes, and cwes (KEV JSON feed (opens in new window)).
Carry three of those fields into the report:
Some vulnerability databases already flag KEV membership inline, and NVD annotates CVE detail pages with a KEV reference and link (NVD on the CISA exploited-vulnerabilities catalog (opens in new window)). Prefer the CISA feed as the source of truth; use inline scanner flags only to cross-check.
Step 4 - Apply VEX assertions
A VEX document is the product owner's statement about whether their product is actually affected by a CVE present in its dependency graph. OpenVEX defines exactly four status labels (OpenVEX specification (opens in new window)):
| Status | Definition (quoted) | Triage effect |
|---|---|---|
not_affected | "No remediation is required regarding this vulnerability." | Set aside from bucketing; still listed in the report |
affected | "Actions are recommended to remediate or address this vulnerability." | Bucket normally |
fixed | "These product versions contain a fix for the vulnerability." | Drop if the scanned version matches the fixed version |
under_investigation | "It is not yet known whether these product versions are affected by the vulnerability." | Bucket normally; never treat as a pass |
A valid statement needs one or more products, a vulnerability identifier, a status label, and a timestamp (same specification).
The rule that matters for triage: for not_affected, a VEX statement "MUST include either a status justification or an impact_statement informing why the product is not affected by the vulnerability" (same specification). The five machine-readable justifications are component_not_present, vulnerable_code_not_present, vulnerable_code_not_in_execute_path, vulnerable_code_cannot_be_controlled_by_adversary, and inline_mitigations_already_exist (same specification).
So:
def apply_vex(finding, statement):
if statement["status"] != "not_affected":
finding["vex_status"] = statement["status"]
return finding
if not (statement.get("justification") or statement.get("impact_statement")):
finding["vex_status"] = "affected" # spec-invalid; refuse the claim
finding["vex_rejected"] = "not_affected without justification"
return finding
finding["vex_status"] = "not_affected"
finding["vex_justification"] = statement.get("justification") \
or statement["impact_statement"]
return findingAn unjustified not_affected is worse than no assertion at all, because it looks like analysis. Reject it and bucket the finding as if the VEX document did not exist.
Set-aside findings still appear in the report with their justification text. The audit trail is the point: a reviewer must be able to check that vulnerable_code_not_in_execute_path was true when it was claimed.
Step 5 - Reachability heuristic
Reachability asks whether the vulnerable code is on any path the application can execute. When a language toolchain can answer this properly, use it. Go's govulncheck "reduces noise by prioritizing vulnerabilities in functions that your code is actually calling" (govulncheck announcement (opens in new window)), which is a call-graph answer rather than a guess.
Without call-graph analysis, these signals approximate it:
| Signal | How to get it | Strength |
|---|---|---|
| Vulnerable function is called | govulncheck ./... for Go modules (govulncheck announcement (opens in new window)) | Strong, direct evidence |
| Dependency is declared but unused | npx knip reports unused dependencies, exports, and files (knip getting started (opens in new window)) | Moderate |
| Dependency is dev-only | npm audit --omit=dev; omitted dependency types "are skipped when generating the report" (npm audit (opens in new window)) | Moderate, if the build genuinely excludes dev deps |
| Vulnerable API is never imported | Grep for the specific symbol named in the advisory | Weak; misses dynamic and transitive use |
Three constraints on using this signal:
Step 6 - Assign a priority bucket
KEV_BUCKET = 'Fix-Now'
EPSS_CRITICAL_GATE = 0.5 # critical severity escalates to Fix-Now above this
EPSS_HIGH_GATE = 0.3 # high severity holds Fix-This-Sprint above this
def priority(f):
if f.get('vex_status') == 'not_affected':
return 'Set-aside-VEX' # reported, not bucketed, not blocking
if f.get('in_kev'):
return KEV_BUCKET # observed exploitation; no other signal overrides
epss = f.get('epss') or 0.0
if f['severity'] == 'critical' and epss > EPSS_CRITICAL_GATE:
return 'Fix-Now'
if f['severity'] == 'critical':
return 'Fix-This-Sprint'
if f['severity'] == 'high' and epss > EPSS_HIGH_GATE:
return 'Fix-This-Sprint'
if f.get('reachable') is False:
return 'Fix-Backlog' # demoted one step, never closed
if f['severity'] == 'high':
return 'Fix-This-Sprint'
if f.get('fix_version') is None and f['severity'] in ('medium', 'low'):
return 'Accept-Risk' # no fix exists and impact is bounded
if f['severity'] == 'medium':
return 'Fix-Backlog'
return 'Accept-Risk'Bucket meanings:
| Bucket | Meaning | Suggested window |
|---|---|---|
| Fix-Now | Exploited in the wild, or critical with a high probability of imminent exploitation | Before the change merges or ships |
| Fix-This-Sprint | Serious and plausibly exploitable, but no confirmed in-the-wild activity | Current sprint or release |
| Fix-Backlog | Real but low urgency, or higher severity with the vulnerable code unreachable | Tracked, next quarter |
| Accept-Risk | Low impact with no fix available, or low severity and unreachable | Documented, re-reviewed on a schedule |
| Set-aside-VEX | Product owner asserted not_affected with a valid justification | No action; audited |
Why these two EPSS numbers. FIRST states plainly that EPSS "thresholds represent statements of risk tolerance" (EPSS model (opens in new window)), so any cut point is a policy choice, not a fact. These two are chosen for where they sit in the distribution: a probability of 0.10 is already near the 88th percentile (Understanding EPSS probabilities and percentiles (opens in new window)), so 0.3 and 0.5 sit far into the tail and fire on a small minority of findings. That is the intent. A gate that fires on a third of the report is not a gate.
Tune by measuring, not by feel: lower EPSS_HIGH_GATE and the Fix-This-Sprint queue grows, raise it and more genuinely exploitable CVEs slip to backlog. Record the values in the report so a reader knows which policy produced the ordering.
Prefer probability for gating, percentile for communicating. Percentiles shift as the corpus grows, so a percentile-based gate quietly changes meaning over time. Report both, gate on the probability (Understanding EPSS probabilities and percentiles (opens in new window)).
Step 7 - The KEV rule: a KEV CVE is never waivable
Hard rule. A CVE listed in the CISA KEV catalog cannot be waived, suppressed, snoozed, marked accepted-risk, or filtered out by any exception mechanism, for any stated reason, by any approver.
The justification is in the catalog's inclusion criteria. KEV membership means CISA holds reliable evidence that an actor executed malicious code against this vulnerability on a system without the owner's permission, and that a clear remediation action exists (Reducing the significant risk of known exploited vulnerabilities (opens in new window)). Every argument normally offered for a waiver has already been answered:
| Waiver argument | Why it fails against KEV |
|---|---|
| "EPSS is low" | EPSS predicts; KEV records what happened. An observation beats a forecast. |
| "The code is unreachable" | Reachability here is a static heuristic with known false negatives (Step 5). It is not strong enough to override observed exploitation. |
| "It is only in a dev dependency" | Then remove it. A KEV entry in the build chain is a supply chain target. |
| "There is no fix" | Criterion 3 means CISA verified a clear remediation action exists; read requiredAction in the feed entry. |
| "We will do it next quarter" | The entry carries a dueDate. Track against that date. |
A not_affected VEX assertion is the one adjacent case, and it is not a waiver: it is a technical claim with a required justification (Step 4) that must name which of the five OpenVEX justifications applies. Hold it to a higher bar for KEV entries: require the justification, a named reviewer, and evidence, and if any of the three is missing, bucket as Fix-Now.
When a KEV entry genuinely cannot be patched today, the answer is compensating action, not an exception: pin to the requiredAction mitigation, remove the dependency, disable the affected feature, or isolate the component at the network boundary. Record the compensating control and the patch date. Never record it as accepted risk.
Worked example
Six findings arrive from a scan of an image and its application dependencies.
Input, before enrichment:
| CVE | Package | Severity | CVSS | Fix |
|---|---|---|---|---|
| CVE-2021-44228 | log4j-core@2.14.1 | critical | 10.0 | 2.17.1 |
| CVE-2024-A | example-parser@1.2.3 | critical | 9.8 | 1.2.5 |
| CVE-2024-B | http-util@3.4.5 | high | 7.5 | 3.4.6 |
| CVE-2024-C | date-fmt@2.0.0 | high | 7.2 | 2.0.1 |
| CVE-2024-D | image-codec@0.9.0 | medium | 5.3 | none |
| CVE-2024-E | shell-wrap@5.1.0 | high | 8.1 | 5.2.0 |
After Steps 2 through 5:
| CVE | EPSS (percentile) | KEV | VEX | Reachable |
|---|---|---|---|---|
| CVE-2021-44228 | 0.944 (99.9th) | yes, dueDate 2021-12-24 | none | false, per knip |
| CVE-2024-A | 0.830 (99.4th) | no | none | true |
| CVE-2024-B | 0.450 (96.8th) | no | none | true |
| CVE-2024-C | 0.006 (72nd) | no | none | false, per knip |
| CVE-2024-D | 0.001 (34th) | no | none | unknown |
| CVE-2024-E | 0.220 (93rd) | no | not_affected, vulnerable_code_not_in_execute_path | true |
Walking Step 6:
Result: 2 Fix-Now, 2 Fix-This-Sprint, 1 Fix-Backlog, 1 Accept-Risk, 1 set aside. Severity-only sorting would have put four of these in the same urgent pile and buried CVE-2024-D entirely.
Expected output
## CVE exploitability triage - build a1b2c3d
**Signals:** EPSS 2026-07-19 snapshot, KEV catalogVersion 2026.07.16,
VEX sbom.openvex.json
**Policy:** critical escalates above EPSS 0.5; high holds above EPSS 0.3
**Findings triaged:** 6 (1 set aside by VEX)
### Fix-Now (2)
| CVE | Package | CVSS | EPSS (pct) | KEV | Reachable | Fix | Deadline |
|---|---|---|---|---|---|---|---|
| CVE-2021-44228 | log4j-core@2.14.1 | 10.0 | 0.944 (99.9) | yes | false* | 2.17.1 | KEV dueDate 2021-12-24 |
| CVE-2024-A | example-parser@1.2.3 | 9.8 | 0.830 (99.4) | no | true | 1.2.5 | before merge |
\* Reachability recorded for context only. KEV entries are not waivable and are
not demoted by a reachability heuristic.
### Fix-This-Sprint (2)
| CVE | Package | CVSS | EPSS (pct) | Fix | Why |
|---|---|---|---|---|---|
| CVE-2024-B | http-util@3.4.5 | 7.5 | 0.450 (96.8) | 3.4.6 | high severity above EPSS gate 0.3 |
### Fix-Backlog (1)
| CVE | Package | CVSS | EPSS (pct) | Reachable | Why |
|---|---|---|---|---|---|
| CVE-2024-C | date-fmt@2.0.0 | 7.2 | 0.006 (72) | false (knip) | below EPSS gate and unreachable |
### Accept-Risk (1)
| CVE | Package | CVSS | EPSS (pct) | Why accepted | Re-review |
|---|---|---|---|---|---|
| CVE-2024-D | image-codec@0.9.0 | 5.3 | 0.001 (34) | medium, no fix published | 2026-10-19 |
### Set aside by VEX (1)
| CVE | Package | Status | Justification | Asserted by |
|---|---|---|---|---|
| CVE-2024-E | shell-wrap@5.1.0 | not_affected | vulnerable_code_not_in_execute_path | platform-team, 2026-07-01 |
### Action items
1. CVE-2021-44228 in log4j-core: KEV entry, upgrade to 2.17.1. Not waivable.
2. CVE-2024-A in example-parser: critical at 99.4th EPSS percentile, upgrade to 1.2.5.
3. Re-review CVE-2024-D on 2026-10-19 in case a fix ships.Two report properties matter more than the layout: every bucket names the rule that produced it, and every signal names its snapshot date. Both exist so the ordering can be re-derived and argued with later.
Anti-patterns
| Anti-pattern | Why it fails | Instead |
|---|---|---|
| Sorting by CVSS alone | CVSS scores intrinsic severity and explicitly leaves organizational risk factors out of scope (CVSS v3.1 specification (opens in new window)) | Add EPSS and KEV (Steps 2 and 3) |
| Reading EPSS as a severity rating | EPSS estimates 30-day exploitation probability and makes no attempt to estimate impact (EPSS FAQ (opens in new window)) | Keep CVSS for impact, EPSS for likelihood |
| Treating a missing EPSS row as 0.0 | Demotes brand-new CVEs and every non-CVE advisory ID | Leave null; fall through to severity (Step 2) |
| Gating on EPSS percentile | Percentiles shift as the scored corpus grows (Understanding EPSS probabilities and percentiles (opens in new window)) | Gate on probability, report percentile |
Accepting not_affected with no justification | OpenVEX requires a justification or impact_statement (OpenVEX specification (opens in new window)) | Reject the claim and bucket normally (Step 4) |
| Closing findings on a reachability heuristic | Static analysis misses dynamic imports and reflection (depcheck (opens in new window)) | Demote one bucket, never close (Step 5) |
| Waiving a KEV CVE because EPSS is low | KEV records observed exploitation; EPSS forecasts it (Reducing the significant risk of known exploited vulnerabilities (opens in new window)) | Fix or compensate (Step 7) |
| Mixing EPSS snapshot dates within one report | Two findings become incomparable | Pin one snapshot per report (Step 2) |
Limitations
Related skills
codeql-queries
Configures and runs GitHub CodeQL - semantic-database SAST with queries written in the CodeQL declarative query language; supports `codeql database create` (per-language) + `codeql database analyze` with --format=sarif; ships query packs (`codeql/javascript-queries`, `codeql/python-queries`, `codeql/java-queries`, `codeql/go-queries`, etc.); integrates with GitHub Code Scanning via SARIF upload; suppression via inline comment + sarif-filter + Security-tab dismissal. Use when the team uses GitHub-hosted repos and needs deep semantic SAST beyond pattern matching (cross-file taint flows, dataflow analysis).
dependabot-config
Reference for `.github/dependabot.yml` - GitHub-native dependency-update orchestrator. Required keys (`version: 2`, `updates[]` array) plus per-update fields (`package-ecosystem`, `directory` / `directories`, `schedule.interval`); common optional fields (`ignore`, `groups`, `allow`, `labels`, `milestone`, `open-pull-requests-limit`, `target-branch`, `vendor`, `versioning-strategy`, `assignees`, `commit-message`); auto-rebase + grouped-PR + security-only updates. Use when authoring or reviewing Dependabot configs in GitHub-hosted repos.
gitleaks-scanning
Configures and runs gitleaks - Go-based secret scanner with `gitleaks git` (scan local git via `git log -p`), `gitleaks dir` (filesystem), `gitleaks stdin` (pipe); 100+ built-in rules + custom rules in `.gitleaks.toml` ([[rules]] with regex / entropy / keywords / tags); allowlist via [[rules.allowlists]] (commits / paths / stopwords); pre-commit hook + GitHub Action integration; plus baseline management for legacy debt - onboarding a repo with historical findings via `--baseline-path` snapshots, `.gitleaksignore`, cross-tool suppression consistency with TruffleHog, and rot-prevention cadence. Use when the team needs OSS secret scanning at commit time + CI gate, or is adopting scanning on a repo with pre-existing findings.
language-native-sast
Language-native SAST linters - the first-party "linter as SAST" family that runs inside each ecosystem's standard toolchain with no separate scanner server: Bandit (Python, 60+ B-rules, severity x confidence filtering), gosec (Go, 40+ G-rules, AST + SSA taint tracking, golangci-lint integration), eslint-plugin-security + eslint-plugin-no-unsanitized (JS/TS, 14 detect-* rules + DOM-sink XSS), and PMD's Apex security ruleset (Salesforce, ApexSOQLInjection / ApexCRUDViolation / ApexSharingViolations). Covers the shared adoption pattern - install as a dev dependency, first scan, suppression-with-justification discipline, baseline-diff adoption for legacy code, SARIF output + CI gating - with per-tool depth in references. Use when a repo needs in-toolchain security linting for Python, Go, JavaScript/TypeScript, or Apex; for cross-language or cross-file taint analysis use semgrep-rules / codeql-queries instead.
multi-tool-finding-triage
Merges two or more security scanner reports into one gate. Use when you need a single BLOCK or PASS decision from multiple scanners instead of reading N separate reports. Normalizes each report into one common finding format (a canonical `Finding`), deduplicates on a per-domain key while recording which scanners agree (`caught_by` consensus), validates a waiver (finding-suppression) file, rejecting any missing `expires:` / `approved_by:` / `reason:` or expired, enriches CVE findings with EPSS (exploit-probability) and CISA KEV (known-exploited catalog), then applies a `fail_on` severity threshold to emit BLOCK or PASS plus a bucketed pull-request comment. Works across static (SAST), dynamic (DAST), secret, dependency (SCA), container, and IaC scanners. To run a single scanner instead use semgrep-rules, codeql-queries, or one of the language-native-sast linters; this runs after them to merge output - the cross-scanner gate, not a single-scanner wrapper.
npm-pip-maven-audit
Configures and runs native package-manager audit commands across ecosystems - `npm audit --audit-level=high` (npm), `yarn npm audit` (Yarn 2+), `pnpm audit` (pnpm), `pip-audit` (Python via PyPA), `mvn dependency:check` (Maven via OWASP Dependency-Check plugin), `cargo audit` (Rust, with `.cargo/audit.toml` suppression, `--deny` semantics, SARIF, binary auditing, and the rustsec/audit-check Action as a reference), and `bundle audit` (Ruby Bundler, with `.bundler-audit.yml` waivers, Rake integration, and CI gating as a reference); fastest no-install-required SCA option. Use when the team wants fast, no-extra-tooling SCA in CI as a first line of defense, when a Rust or Ruby repo needs its ecosystem-native scanner, or pairs with snyk/osv-scanner for layered coverage.
nuclei-dast
Installs and runs ProjectDiscovery Nuclei template-based HTTP scanning: selects templates via `-t {path}` and `-tags`/`-severity` filters, controls request rate with `-rl`, emits JSONL output via `-j` for cross-tool finding aggregation, authors custom YAML matchers for app-specific checks, and gates CI on severity thresholds. Use when the team runs Nuclei alongside ZAP for template-driven DAST coverage, needs fuzzing-style probes beyond ZAP passive scan, or wants to operationalize community CVE templates in a pipeline.
osv-scanner
Configures and runs Google OSV-Scanner - open-source SCA against the OSV.dev vulnerability database; supports `osv-scanner scan -r ./` recursive scan + per-lockfile scan via `-L package-lock.json`; SBOM input (CycloneDX / SPDX) for non-standard package managers; `--format json|sarif|markdown|vertical|html` output; suppressions via `osv-scanner.toml` config. Use when the team needs OSS-native SCA without commercial-license overhead, or wants a second-opinion DB pair with Snyk's commercial DB.
reachability-analyzer
Runs dead-dependency analysis across JS, Python, and Rust projects using ecosystem-native static tools (`depcheck`/`knip` for JS, `vulture` for Python, `cargo-machete` for Rust), then cross-references the unused-dependency list against SCA findings to downrank vulns in code that is never loaded. Use when SCA output (from `osv-scanner`, `snyk-test`, or `npm-pip-maven-audit`) is too noisy to triage and the team needs to separate unreachable CVEs from exploitable ones before sprint planning; sibling cve-exploitability-triage ranks by EPSS/KEV exploitation signal, not code reachability.
renovate-config
Reference for `renovate.json` - Mend Renovate dependency-update orchestrator (multi-platform: GitHub / GitLab / Bitbucket / Azure DevOps / Gitea); top-level keys (`extends` for preset references, `schedule`, `prConcurrentLimit`, `vulnerabilityAlerts`); `packageRules[]` array with `matchPackageNames` / `matchUpdateTypes` / `automerge` matching; `ignoreDeps`, `addLabels`, `automergeSchedule`. Use when authoring or reviewing Renovate configs in any repo platform Renovate supports.
sbom-formats
Reference for the two SBOM specification families and how to choose between them - CycloneDX v1.6 (OWASP-curated, security-focused: components, services, dependencies, first-class vulnerabilities[] with embedded VEX, formulation, ML/SaaS BOMs; XML / JSON / Protobuf) as the primary format, with SPDX 2.3 + 3.0 (Linux Foundation, license-focused: packages, relationships, license expressions, Tag-Value/JSON encodings, ISO/IEC 5962:2021) covered as a reference. Includes per-language generators, schema validation, sign + attest CI wiring, and the format-choice guidance (CycloneDX for security-focused consumers; SPDX for US Federal procurement, Linux Foundation, and license-compliance contexts). Use when the user asks to write or validate an SBOM in CycloneDX or SPDX form, or the team must pick its SBOM format.
secrets-rotation-runner
Build-an-X for the secret-rotation workflow after detection - detect via gitleaks/trufflehog/kingfisher → identify provider via verifier → rotate via provider API (AWS IAM / GitHub PAT / Stripe / GCP / Azure / Twilio / Slack / etc.) → invalidate old secret → audit log via observability stack → post-mortem cross-ref. Use when a secret is detected in code (or proactively for periodic rotation) - assume git-history scrub does NOT prevent compromise.
semgrep-rules
Configures and runs Semgrep - pattern-based SAST across 30+ languages with the Semgrep Registry rulesets (`p/owasp-top-ten`, `p/default`, `auto`) plus custom YAML rules; integrates `semgrep ci` for PR-blocking gates with `--baseline-commit` diff-aware scanning, per-finding inline `nosemgrep` suppressions, `--exclude` / `--include` path filters, output formats (`--json` / `--sarif` / `--gitlab-sast` / `--junit-xml`), and severity filter (INFO/WARNING/ERROR). Use when the user runs Semgrep, asks about pattern rules, or needs a low-friction SAST gate without semantic-DB setup.
snyk-test
Configures and runs Snyk, a commercial multi-mode scanner: snyk test for SCA (dependency scanning), snyk code test for SAST (code security scanning), snyk container test for container images, snyk iac test for IaC (infrastructure-as-code), snyk monitor for continuous new-vuln alerts; policy file .snyk for ignore + patch. Use when the team has a Snyk license and needs SCA (dependency scanning) or continuous vuln monitoring; for open-source scanning without a Snyk license, prefer osv-scanner.
sonarqube-rules
Configures and runs SonarQube / SonarCloud - multi-language SAST + Quality Gate platform with built-in Sonar Way rule profiles + custom rule plugins; integrates `sonar-scanner` with `sonar-project.properties` config; supports Quality Gate definitions including new-code-period blocking, branch + PR analysis, and per-issue suppression via `// NOSONAR` comment or `@SuppressWarnings("squid:RULE_ID")` annotation. Use when the user runs SonarQube Community / Developer / Enterprise edition or SonarCloud, or needs a multi-language SAST + code-quality platform with persistent issue tracking.
syft-generation
Generates, scans, and diffs Software Bills of Materials (SBOMs) with the Anchore stack - Syft generation from container images / directories / archives across OCI / Docker / Singularity formats (output CycloneDX-JSON / SPDX-JSON / Syft-JSON / table / GitHub-JSON, cosign attestation); the paired generate + scan workflow with Grype (`grype sbom:./sbom.json`, `--fail-on high`, `--only-fixed`, `.grype.yaml` ignore rules with mandatory `expires:`, EPSS/KEV prioritization); and SBOM-to-SBOM diffing via `cyclonedx diff --component-versions` to gate CI on net-new components and detect supply-chain drift between builds. Use when the team needs SBOM artifacts for compliance (US EO 14028, EU CRA, FDA medical-device guidance), SBOM-driven vulnerability scanning, or dependency-drift detection between releases.
trivy-image
Configures and runs Trivy for container image scanning: Aqua Security's all-in-one scanner combining vuln + secret + misconfiguration + license detection in one pass; `trivy image {image}` with --severity HIGH,CRITICAL filter; --format sarif/json (incl. scan-embedded CycloneDX; for standalone SBOM generation see syft-generation + sbom-formats); .trivyignore CVE suppression file; --ignore-unfixed for actionable filter; --scanners vuln/misconfig/license/secret toggle. Use when the team wants a single tool covering container image security across multiple dimensions, not for producing a standalone CycloneDX SBOM.
trufflehog-scanning
Configures and runs TruffleHog v3 - secret scanner with **live verification** (validates discovered secrets against provider APIs to confirm actual exposure vs entropy false positive); supports per-source subcommands (`git`, `github`, `gitlab`, `filesystem`, `s3`, `docker`, `gcs`, `postman`); `--results=verified` filter for high-precision output; `--exclude-detectors=TYPE` for noise reduction; exits 183 on findings via `--fail`. Use when the team needs verified secret findings (low false-positive rate) or scans across cloud + repo + container surfaces.
vex-author
Authors and validates OpenVEX documents - produces `not_affected`, `affected`, `fixed`, and `under_investigation` statements with justification codes using `vexctl create`; attaches VEX assertions to container images; outputs `.openvex.json` files consumed on a downstream VEX-filter / vulnerability-prioritization path. Use when a scanner flags a CVE that analysis confirms is not exploitable in your deployment, and a machine-readable `not_affected` assertion is needed to suppress false positives without discarding the finding from the audit trail.
zap-baseline
Configures and runs OWASP ZAP baseline scanning: `zap-baseline.py` Docker-packaged spider + passive scan suitable for CI gating; supports `-t target_url` + `-r html_report` + `-c config_file` rule customization (INFO/IGNORE/FAIL warnings) and Ajax spider via `-j` for JS-heavy SPAs; `zap-full-scan.py` active companion for staging. Covers authenticated scans end to end as a reference - ZAP Context, auth methods (form/JSON/script/browser), session management, verification strategy, OAuth/bearer injection, context XML export for `-n` - plus DAST cadence planning (PR-blocking passive baseline, nightly ZAP full + nuclei active layer, baseline-finding ratchet for legacy apps). Use when the user runs OWASP ZAP for pre-prod web app DAST, needs coverage of routes behind a login wall, or is designing a team's DAST rollout cadence.