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/zoom-meeting-context
tools
VerifiedTrustedCommunity
Zoom meeting intelligence — correlates a live or referenced Zoom meeting discussion against NetClaw's historical meeting record (via the official Zoom Meetings MCP) and today's actual network state. Use when someone in a Zoom meeting references a past discussion or incident ('didn't we have this issue before?'), or asks to search prior meetings for a topic. Does not itself recognize live in-meeting questions — that happens automatically inside zoom-rtms-mcp's own extractor (spec 118) before this skill is ever invoked.
644SKILL.mdUpdated Aug 27, 2026
automateyournetwork/percepxion-oob
tools
VerifiedTrustedCommunity
Manage Lantronix out-of-band (OOB) infrastructure via Percepxion central management platform: device inventory, serial port inspection via SLC CLI, firmware compliance, config management, security auditing, and closed-loop incident remediation. Use during outages, maintenance windows, compliance cycles, and AI-assisted automation workflows.
644SKILL.mdUpdated Aug 13, 2026
automateyournetwork/n2n-federation
tools
VerifiedTrustedCommunity
Federate your NetClaw with other NetClaw operators over the BGP mesh — exchange capability inventories and ask your claw what a peer can do. (US1; remote invocation and chat land in later phases.)
638SKILL.mdUpdated Jul 11, 2026
automateyournetwork/token-tracker
tools
VerifiedTrustedCommunity
Track token consumption, enforce session budgets, and display cost for every NetClaw interaction.
638SKILL.mdUpdated Apr 3, 2026