automateyournetwork/netclaw/claroty-risk-triage

Claude Code and agent skill by automateyournetwork/netclaw

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Triage Claroty xDome alerts and vulnerabilities, compute blast radius, correlate with NVD CVE data, and drive ITSM-gated workflow actions (acknowledge, label, assign, set relevance).

Install

npx vskill@latest install automateyournetwork/netclaw/claroty-risk-triage

SKILL.md

The same SKILL.md was published earlier as automateyournetwork/netclaw/claroty-risk-triage.

Claroty Risk Triage

Unified alert + vulnerability triage for OT / IoT / IoMT environments via Claroty xDome. Alerts and vulnerabilities are bundled into one skill because real incident response crosses the boundary constantly — operators investigate an alert, pivot to the affected device's CVE list, and back to the alert label.

When to Use

  • Triaging Claroty xDome alerts by severity, site, or assignee
  • Computing the blast radius of an alert (which devices, which protocols)
  • Inspecting vulnerability findings, filtering by CVSS, and listing affected devices
  • Marking a CVE as not-relevant for a specific device (mitigation in place, compensating control, patched out-of-band)
  • Acknowledging, labelling, or assigning alerts during a hunt
  • Handing off to ise-incident-response for endpoint quarantine or to servicenow-change-workflow for a remediation CR

MCP Server

  • Server: claroty-mcp
  • Command: python3 -u mcp-servers/claroty-mcp/claroty_mcp_server.py (stdio transport)
  • Auth: Bearer token via CLAROTY_API_TOKEN
  • ITSM: Write operations require a CHG\d+ CR; bypassed in NETCLAW_LAB_MODE=true

Available Tools

ToolParametersWhat It Does
list_alertsseverity?, status?, site_id?, assignee?, limit?, offset?, max_items?List security alerts with filters
get_alert_with_devicesalert_id, device_limit?Alert + affected devices in one call
list_vulnerabilitiesseverity?, cvss_min?, cve_contains?, limit?, offset?, max_items?List CVE-aligned findings
get_vulnerable_devicesvulnerability_id, limit?, offset?Devices affected by one CVE (blast radius)
acknowledge_alertalert_id, resolution, cr_number, note?Write (ITSM-gated) — set resolution state
set_vulnerability_relevancedevice_id, vulnerability_id, relevant, cr_number, note?Write (ITSM-gated) — suppress / re-enable CVE on a device
label_alertsalert_ids, labels, cr_number, replace?Write (ITSM-gated) — apply / replace labels
assign_alertsalert_ids, assignee, cr_number, note?Write (ITSM-gated) — assign alerts to a user / queue

Compose with:

  • nvd_get_cve from the nvd-cve skill for full CVSS vector decomposition
  • ise-incident-response skill for endpoint quarantine
  • servicenow-change-workflow skill to open a remediation CR if the alert demands a config change

Workflow Examples

Triage all high-severity open alerts
"List all open high-severity alerts at site warehouse-east"

Calls list_alerts(severity="high", status="open", site_id="warehouse-east"). Returns severity-sorted alert table.

Blast-radius investigation
"Show me alert a1b2c3 and every device it touches"

Calls get_alert_with_devices(alert_id="a1b2c3") and renders the alert metadata plus affected devices. From there, pivot to list_vulnerabilities filtered by site to understand combined risk.

CVE blast radius across the fleet
"What devices are vulnerable to CVE-2024-12345? Correlate with NVD for full context."
  1. list_vulnerabilities(cve_contains="2024-12345") → xDome finding ID.
  2. get_vulnerable_devices(vulnerability_id="<id>") → affected device list.
  3. nvd_get_cve(cve_id="CVE-2024-12345") (nvd-cve skill) → CVSS vector, references, fix availability.
  4. Optionally list_devices with cross-reference to Nautobot to confirm criticality.
Suppress a known false positive
"Mark CVE-2024-12345 as not-relevant for device 7a2c (mitigated by network ACL) under CHG0013001"

Calls set_vulnerability_relevance(device_id="7a2c...", vulnerability_id="<id>", relevant=False, cr_number="CHG0013001", note="mitigated by network ACL").

Label and assign an alert during a hunt
"Label alerts [a1, a2, a3] as 'ransomware-candidate' and assign to alice under CHG0013002"
  1. label_alerts(alert_ids=[...], labels=["ransomware-candidate"], cr_number="CHG0013002").
  2. assign_alerts(alert_ids=[...], assignee="alice", cr_number="CHG0013002").
Acknowledge after remediation
"Acknowledge alert a1b2c3 as resolved with a note pointing at CHG0013001's evidence"

Calls acknowledge_alert(alert_id="a1b2c3", resolution="resolved", cr_number="CHG0013001", note="...").

ITSM gating

Identical to other Claroty write tools: CHG\d+ format, ServiceNow "Implement" state check (skipped in lab mode). Rejected gate returns {"itsm_gate": {...}, "applied": false} and the xDome write is not made.

ISE handoff pattern

If a Claroty alert resolves to "compromised endpoint", do NOT call ISE quarantine from inside this skill. Hand off to ise-incident-response per Principle XIV (human-in-the-loop for external actions). That skill enforces the human decision point before any quarantine action.

Token scope expectations

If a write tool returns applied: false and an error object with status_code: 403, the ITSM gate passed and the body was correctly built — xDome rejected at RBAC. The token in CLAROTY_API_TOKEN lacks write scope on the relevant resource (alerts for acknowledge_alert/label_alerts/assign_alerts; vulnerabilities for set_vulnerability_relevance). Don't retry — escalate to whoever provisions xDome API tokens. The wrapper surfaces xDome's response body verbatim so you can see exactly which scope is missing.

Security

  • Security scanPassed, 82 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
674
Repository forks
189
7-day trend score
33

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/automateyournetwork/netclaw/claroty-risk-triage/badge)](https://verified-skill.com/skills/automateyournetwork/netclaw/claroty-risk-triage)

Something wrong with this skill or its page? Tell us.