automateyournetwork/suzieq-observability
workspace/skills/suzieq-observability/SKILL.md
SuzieQ network observability — query current and historical network state, run validation assertions, get summary statistics, trace forwarding paths, and discover unique values across 20+ network tables. Use when investigating BGP/OSPF state, checking interface health, performing time-travel queries, validating network assertions, or tracing packet paths through the network via SuzieQ.
$ install --global
skillsauthnpx skillsauth add automateyournetwork/netclaw suzieq-observabilityInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 24, 2026, 10:35 PM1.5s1 file scanned
SKILL.md
- name:
- suzieq-observability
- description:
- SuzieQ network observability — query current and historical network state, run validation assertions, get summary statistics, trace forwarding paths, and discover unique values across 20+ network tables. Use when investigating BGP/OSPF state, checking interface health, performing time-travel queries, validating network assertions, or tracing packet paths through the network via SuzieQ.
- license:
- Apache-2.0
- user-invocable:
- true
- { "openclaw":
- { "requires": { "bins": ["python3"], "env": ["SUZIEQ_API_URL", "SUZIEQ_API_KEY"] } } }
SuzieQ Network Observability
Server & Configuration
- Server script:
mcp-servers/suzieq-mcp/server.py - Transport: stdio (JSON-RPC 2.0)
- Environment variables:
SUZIEQ_API_URL,SUZIEQ_API_KEY - Optional:
SUZIEQ_VERIFY_SSL(default: true),SUZIEQ_TIMEOUT(default: 30s)
All 5 Available Tools
1. suzieq_show
Query detailed network state data from any SuzieQ table. Supports filtering by device, namespace, time range, and columns. Use for current or historical (time-travel) network state queries.
table(string, required): SuzieQ table name (e.g., "bgp", "route", "interface")namespace(string): Filter by SuzieQ namespacehostname(string): Filter by device hostnamecolumns(string): Comma-separated column names to returnstart_time(string): Start time for time-travel query (ISO 8601 or relative e.g., "1h", "2d")end_time(string): End time for time-travel queryview(string): Data view: "latest", "all", or "changes"filters(string): Additional key=value pairs separated by ampersand
Use when: Querying current network state, investigating specific devices, performing time-travel queries for historical analysis.
2. suzieq_summarize
Get aggregated statistics and summary views of any SuzieQ network table. Returns counts, distributions, and per-device breakdowns.
table(string, required): SuzieQ table namenamespace(string): Filter by SuzieQ namespacehostname(string): Filter by device hostnamestart_time(string): Start time for historical summaryend_time(string): End time for historical summary
Use when: Getting high-level network overview, distribution analysis, capacity planning.
3. suzieq_assert
Run validation assertions against network state. Checks conditions like "all BGP peers established" or "no interface errors".
table(string, required): Must be one of: bgp, ospf, interface, evpnVninamespace(string): Filter by SuzieQ namespacehostname(string): Filter by device hostname
Use when: Validating network health, pre/post-change verification, compliance checks.
4. suzieq_unique
Get distinct values and their counts for a specific column in a SuzieQ table.
table(string, required): SuzieQ table namecolumn(string, required): Column name to get unique values fornamespace(string): Filter by SuzieQ namespacehostname(string): Filter by device hostname
Use when: Understanding value distributions (unique VRFs, BGP states, interface types).
5. suzieq_path
Trace the forwarding path between two endpoints through the network.
namespace(string, required): SuzieQ namespacesource(string, required): Source IP addressdestination(string, required): Destination IP addressvrf(string): VRF name (default: "default")
Use when: Troubleshooting connectivity, verifying forwarding paths, path analysis.
Workflow
- Start with
suzieq_showorsuzieq_summarizeto understand current network state - Use
suzieq_assertto validate health (BGP established, OSPF full, interfaces up) - Use
suzieq_uniqueto explore value distributions for specific columns - Use
suzieq_pathto trace forwarding paths between endpoints - Use
start_time/end_timeon show/summarize for time-travel historical analysis
Supported Tables
address, arpnd, bgp, device, devconfig, evpnVni, fs, ifCounters, interface, inventory, lldp, mac, mlag, namespace, network, ospf, route, sqPoller, topology, vlan
Related Skills
automateyournetwork/humanrail-escalation
testing
VerifiedTrustedCommunity
Human-in-the-loop escalation via HumanRail — route low-confidence agent decisions, pre-destructive operation approvals, and ambiguous incident tickets to real human engineers. Human answers are verified and returned as structured output. Workers are paid via Lightning Network. Use when the agent is uncertain, when a destructive change needs explicit human sign-off beyond a ServiceNow CR, or when an ambiguous ticket requires human triage before automated handling.
491SKILL.mdUpdated May 12, 2026
automateyournetwork/eve-ng-node-operations
testing
VerifiedTrustedCommunity
Manage EVE-NG node lifecycle. Use when listing nodes, checking runtime state, creating or deleting nodes, starting or stopping nodes or whole labs, verifying node details, or wiping node NVRAM back to factory defaults.
491SKILL.mdUpdated May 12, 2026
automateyournetwork/eve-ng-lab-management
development
VerifiedTrustedCommunity
Manage EVE-NG labs and platform inventory. Use when listing labs, checking lab metadata, creating or deleting labs, importing or exporting lab archives, checking EVE-NG health or auth, or verifying available node images before build work.
491SKILL.mdUpdated May 12, 2026
automateyournetwork/eve-ng-console-ops
tools
VerifiedTrustedCommunity
Execute live CLI commands on running EVE-NG nodes over telnet console. Use when running show commands, making live config changes, verifying protocol state, testing connectivity, checking console readiness, or interacting with IOS, Junos, VPCS, EOS, or NX-OS nodes.
491SKILL.mdUpdated May 12, 2026