Lab 1b solution. Use this skill to get the current operational state of a single node in the lab fabric as structured data that another skill or a human can act on. This is the first of the two composable skills; change-validation calls it to snapshot state before and after a change.

Scope

One node, read-only. Nodes: spine1, spine2, leaf1, leaf2.

Steps

Validate <node> is a known fabric node; otherwise return an error object.
Container name is clab-skills-specs-lab-<node>.
Run, capturing output:
- docker exec clab-skills-specs-lab-<node> sr_cli "show interface brief"
- docker exec clab-skills-specs-lab-<node> sr_cli "show network-instance default protocols bgp neighbor"
Extract per-interface admin/oper state and per-neighbor peer, peer-AS, and session state.

Output

{
  "node": "<node>",
  "captured_at": "<iso8601>",
  "interfaces": [{"name": "ethernet-1/1", "oper": "up"}],
  "bgp": [{"peer": "10.1.1.1", "peer_as": 65100, "state": "established"}],
  "healthy": true
}

Keep the structure stable across calls. change-validation diffs two of these, so field names and shape must not vary between the pre and post snapshot.

Failure modes

Unknown node: {"error": "unknown node <name>"}.
Container down: {"node": "<node>", "error": "container not running"}.
Empty or unparseable CLI output: return healthy: false with a note, never a half-parsed object.

Más de este repositorio

mismo repositorio

change-validation

wcollins/skills-and-specs-lab

Snapshot a node's state before and after a change, then report exactly what changed and whether the fabric is still healthy

2026-06-303

example-skill

wcollins/skills-and-specs-lab

Summarize a single piece of fabric state in a structured way, instead of returning a raw tool dump (replace this with your own one-line, verb-first description that says when to use the skill)

2026-06-303

contributing

wcollins/skills-and-specs-lab

Walk a workshop participant through contributing a skill or lab back to the Skills & Specs Lab via fork and pull request, including GitHub PAT setup

2026-06-213

network-state-query

wcollins/skills-and-specs-lab

Return a focused, structured health summary for one fabric node (interfaces and BGP), instead of a raw tool dump

2026-06-213

skills-creator

wcollins/skills-and-specs-lab

Scaffold a new agentskills.io SKILL.md from a short description, with the right frontmatter, a focused scope, and a quality checklist

2026-06-213

name	device-state-query
description	Query one fabric node and return its interface and BGP state as structured JSON
state	draft

Device state query

Scope

One node, read-only. Nodes: spine1, spine2, leaf1, leaf2.

Steps

Validate <node> is a known fabric node; otherwise return an error object.
Container name is clab-skills-specs-lab-<node>.
Run, capturing output:
- docker exec clab-skills-specs-lab-<node> sr_cli "show interface brief"
- docker exec clab-skills-specs-lab-<node> sr_cli "show network-instance default protocols bgp neighbor"
Extract per-interface admin/oper state and per-neighbor peer, peer-AS, and session state.

Output

{
  "node": "<node>",
  "captured_at": "<iso8601>",
  "interfaces": [{"name": "ethernet-1/1", "oper": "up"}],
  "bgp": [{"peer": "10.1.1.1", "peer_as": 65100, "state": "established"}],
  "healthy": true
}

Keep the structure stable across calls. change-validation diffs two of these, so field names and shape must not vary between the pre and post snapshot.

Failure modes

Unknown node: {"error": "unknown node <name>"}.
Container down: {"node": "<node>", "error": "container not running"}.
Empty or unparseable CLI output: return healthy: false with a note, never a half-parsed object.