Vulnetix SOC Triage Skill
Use when
- Start of a SOC shift: "what landed overnight that hits our deps?".
- Building today's P1–P4 action list grouped by package manager.
- Filtering for KEV-only or EPSS > 0.5 items intersected with installed packages.
- Producing a handoff watchlist for the next shift.
- Weekly all-hands prep: top 10 items the team should know about.
Don't use for
- Single-CVE deep-dive — use
/vulnetix:vulnor/vulnetix:exploits. - Cross-CVE exploit search by ecosystem — use
/vulnetix:exploits-search. - Applying fixes — use
/vulnetix:fixper item.
Conventions
This skill follows _lib/contract.md: the Vulnetix CLI is auto-installed by hooks, .vulnetix/capabilities.yaml is always present, every vulnetix vdb call is piped through a verified jq filter from _lib/jq/, independent calls run in parallel as concurrent Bash tool calls, and trailing follow-ups are limited to one line. See the contract for output style, memory write rules, and cooldowns.
The "daily SOC pull" — fetches Vulnetix's score-driven triage feed, narrows it to ecosystems / packages this repo actually uses (per .vulnetix/capabilities.yaml), and produces a ranked action list.
Step 1: Load capabilities
Read .vulnetix/capabilities.yaml. Use derived.primary_package_manager and the repo.* flags to choose the ecosystem filter. If the file is missing, run ${CLAUDE_PLUGIN_ROOT}/hooks/capabilities-detect.sh first.
Step 2: Verify CLI availability
command -v vulnetix &>/dev/null || (see /vulnetix:vuln Step "CLI Availability" for install)
Step 3: Pull the triage feed
vulnetix vdb triage $ARGUMENTS -o json | jq -f "${CLAUDE_PLUGIN_ROOT}/skills/_lib/jq/triage.jq"
Default arguments: --limit 50. Honor user-supplied --severity, --ecosystem, --in-kev, --min-epss, --since, --sort flags by passing through $ARGUMENTS.
Step 4: Cross-reference with repo
For each item in the feed:
- Use Grep on lockfiles (matched by
derived.primary_package_manager) to check if the affected package is present. - Mark
In repo?= direct / transitive / not-found. - Cross-reference
.vulnetix/memory.yamlfor prior triage decisions (skip already-decided P3/P4 unless re-flagged).
Step 5: Render ranked report
Markdown table grouped by P1 / P2 / P3 / P4 (priority tiers from the feed):
| ID | Package | Severity | EPSS | KEV | In repo? | Action |
Suggested actions per row:
In repo? = direct+ KEV →/vulnetix:fix <id>(urgent)In repo? = directno KEV →/vulnetix:remediation <id>In repo? = transitive→/vulnetix:safe-harbor-resolver(agent)In repo? = not-foundbut high P1 → log only, no action
Step 6: Memory update
Append event: soc-triage history entries for any newly surfaced vulns (status: under_investigation). Single consolidated write.
Notes
- Use
-o jsonfor parseable output. Pipe tojqfor filtering. - Honor
derived.detection_stack— for vulns without fixes, suggest/vulnetix:detection-rules <id>only when at least one ofsnort,suricata,yara,nucleiis in the stack. - For SOAR=stix, suggest
/vulnetix:ioc-pivot <id> --format stixfor high-severity items.
Edge cases & gotchas
- Triage feed is rate-limited on community auth — keep
--limit 50or less to avoid 30s timeout retries. - Repo-impact cross-reference happens client-side; if
.vulnetix/capabilities.yamlshowsprimary_package_manager: unknown, the cross-reference is skipped and all items appear regardless of repo deps. - Default sort is by score descending; for date-ordered use
--sort recent. --since YYYY-MM-DDis server-side; older windows hit a cold cache and add 1-2s.- Memory writes use
--disable-memoryon inner calls and a single consolidated write at the end — never run two/vulnetix:soc-triageinvocations in parallel from the same session.