Node Connect
openclaw/openclaw
Diagnose OpenClaw Control UI browser and native Android, iOS, or macOS node connection failures across route, auth, pairing, QR/setup-code, and reconnect states.
Build CML topologies — add nodes, create interfaces, wire links, set link conditioning, add annotations.
Apache-2.0Auto-check passed
Install Cml Topology Builder
$ npx skills add automateyournetwork/netclaw --skill cml-topology-builder -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install automateyournetwork/netclaw cml-topology-builder --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/automateyournetwork/netclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/workspace/skills/cml-topology-builder .claude/skills/cml-topology-builder && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "cml-topology-builder" agent skill from https://github.com/automateyournetwork/netclaw/tree/main/workspace/skills/cml-topology-builder into .claude/skills/cml-topology-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cml-topology-builder", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/automateyournetwork/netclaw/tree/main/workspace/skills/cml-topology-builderType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add automateyournetwork/netclaw --skill cml-topology-builder -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install automateyournetwork/netclaw cml-topology-builder --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/automateyournetwork/netclaw.git skills-src && mkdir -p .agents/skills && cp -r skills-src/workspace/skills/cml-topology-builder .agents/skills/cml-topology-builder && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "cml-topology-builder" agent skill from https://github.com/automateyournetwork/netclaw/tree/main/workspace/skills/cml-topology-builder into .agents/skills/cml-topology-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cml-topology-builder", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add automateyournetwork/netclaw --skill cml-topology-builder -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install automateyournetwork/netclaw cml-topology-builder --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/automateyournetwork/netclaw.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/workspace/skills/cml-topology-builder .cursor/skills/cml-topology-builder && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "cml-topology-builder" agent skill from https://github.com/automateyournetwork/netclaw/tree/main/workspace/skills/cml-topology-builder into .cursor/skills/cml-topology-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cml-topology-builder", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/automateyournetwork/netclaw.git --path workspace/skills/cml-topology-builder--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add automateyournetwork/netclaw --skill cml-topology-builder -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install automateyournetwork/netclaw cml-topology-builder --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/automateyournetwork/netclaw.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/workspace/skills/cml-topology-builder .gemini/skills/cml-topology-builder && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "cml-topology-builder" agent skill from https://github.com/automateyournetwork/netclaw/tree/main/workspace/skills/cml-topology-builder into .gemini/skills/cml-topology-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cml-topology-builder", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install automateyournetwork/netclaw cml-topology-builderInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add automateyournetwork/netclaw --skill cml-topology-builder -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/automateyournetwork/netclaw.git skills-src && mkdir -p .github/skills && cp -r skills-src/workspace/skills/cml-topology-builder .github/skills/cml-topology-builder && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "cml-topology-builder" agent skill from https://github.com/automateyournetwork/netclaw/tree/main/workspace/skills/cml-topology-builder into .github/skills/cml-topology-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cml-topology-builder", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add automateyournetwork/netclaw --skill cml-topology-builder -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install automateyournetwork/netclaw cml-topology-builder --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/automateyournetwork/netclaw.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/workspace/skills/cml-topology-builder .opencode/skills/cml-topology-builder && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "cml-topology-builder" agent skill from https://github.com/automateyournetwork/netclaw/tree/main/workspace/skills/cml-topology-builder into .opencode/skills/cml-topology-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cml-topology-builder", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
cml-topology-builder- GitHub stars
- 676
- Token cost
- ~1.8k tokens
- SKILL.md length
- 759 words
- Files
- 1
- Skills in repo
- 120
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Build CML topologies — add nodes, create interfaces, wire links, set link conditioning, add annotations.
- Works in 9 steps: Create the lab (or get an existing one… → Get node definitions: get_node_defs to… → Plan the layout: Calculate x,y… → …
- Building a network topology in CML
- SKILL.md covers MCP Server, Available Tools, Available Node Definitions and Workflow: Build Topology from…, plus 6 more sections
- Needs CML_PASSWORD
What it does
Cml Topology Builder is an agent skill from automateyournetwork/netclaw. Build CML topologies — add nodes, create interfaces, wire links, set link conditioning, add annotations. Use when building a network topology in CML, adding routers or switches to a lab, wiring links between nodes, or simulating WAN conditions.
Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
The repository describes itself as: An AI agent that claws through your network. The licence is Apache-2.0.
When your agent uses it
- Building a network topology in CML
- Switches to a lab
- Wiring links between nodes
- Simulating WAN conditions
Example prompts
- “/cml-topology-builder”
Workflow steps
9 steps, taken from the first numbered list in SKILL.md.
- Create the lab (or get an existing one via get_lab)
- Get node definitions: get_node_defs to know what's available
- Plan the layout: Calculate x,y coordinates for visual placement
- Create nodes: create_node for each device with meaningful labels
- Create interfaces: create_interface for each connection point
- Wire links: create_link to connect interface pairs
- Set conditions (if requested): set_link_condition for WAN links
- Add annotations: create_annotation for labels, IP addressing plans
- Report the topology: List all nodes, interfaces, and links
What it can do on your machine
Read from SKILL.md and the folder at commit aa90e7d. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
CML_PASSWORD
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Cml Topology Builder loads about 1.8k tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 759 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from automateyournetwork/netclaw at commit aa90e7d, republished under its Apache-2.0 licence (© automateyournetwork). 759 words, ~1,847 tokens.
Download SKILL.mdSave it as
.claude/skills/cml-topology-builder/SKILL.md (or your agent's skills folder).- name
- cml-topology-builder
- description
- Build CML topologies — add nodes, create interfaces, wire links, set link conditioning, add annotations. Use when building a network topology in CML, adding routers or switches to a lab, wiring links between nodes, or simulating WAN conditions.
- version
- 1.0.0
- license
- Apache-2.0
- tags
- cml, topology, nodes, links, interfaces
CML Topology Builder
MCP Server
- Command:
cml-mcp(pip-installed, stdio transport) - Requires:
CML_URL,CML_USERNAME,CML_PASSWORDenvironment variables
Available Tools
Node Management
| Tool | Parameters | What It Does |
|---|---|---|
get_node_defs | none | List all available node definitions (IOSv, NX-OS, IOS-XR, etc.) |
create_node | lab_id/lab_title, node_def, label, x, y | Add a node to a lab |
get_nodes | lab_id/lab_title | List all nodes in a lab |
get_node | lab_id/lab_title, node_id/node_label | Get details of a specific node |
Interface Management
| Tool | Parameters | What It Does |
|---|---|---|
create_interface | lab_id/lab_title, node_id/node_label, slot? | Create a new interface on a node |
get_interfaces | lab_id/lab_title, node_id/node_label | List all interfaces on a node |
get_interface | lab_id/lab_title, node_id/node_label, interface_id/interface_label | Get interface details |
Link Management
| Tool | Parameters | What It Does |
|---|---|---|
create_link | lab_id/lab_title, src_node/src_label, src_intf, dst_node/dst_label, dst_intf | Create a link between two interfaces |
get_links | lab_id/lab_title | List all links in a lab |
get_link | lab_id/lab_title, link_id | Get link details |
set_link_condition | lab_id/lab_title, link_id, bandwidth?, latency?, jitter?, loss? | Set link conditioning (WAN simulation) |
set_link_state | lab_id/lab_title, link_id, state | Set link state (up/down) — simulate link failures |
Annotations
| Tool | Parameters | What It Does |
|---|---|---|
create_annotation | lab_id/lab_title, annotation_type, content, x, y, width?, height? | Add a text/shape annotation |
get_annotations | lab_id/lab_title | List all annotations |
delete_annotation | lab_id/lab_title, annotation_id | Remove an annotation |
Available Node Definitions
Common node types available in CML (use get_node_defs to get the full list):
| Node Definition ID | Description | Typical Use |
|---|---|---|
iosv | Cisco IOSv (IOS 15.x) | Routing, switching labs |
iosvl2 | Cisco IOSv L2 | Layer 2 switching labs |
iosxrv9000 | Cisco IOS XR 9000v | SP, MPLS, Segment Routing |
nxosv9000 | Cisco NX-OS 9000v | Data center, VXLAN |
csr1000v | Cisco CSR 1000v (IOS-XE) | SD-WAN, routing |
cat8000v | Cisco Catalyst 8000v | Enterprise routing |
asav | Cisco ASAv | Firewall labs |
server | Ubuntu/Alpine server | Traffic gen, testing |
external_connector | External bridge | Connect lab to host/internet |
unmanaged_switch | Unmanaged L2 switch | Simple L2 connectivity |
wan_emulator | WAN emulator | Add latency/loss between nodes |
Workflow: Build Topology from Description
When the user describes a topology:
- Create the lab (or get an existing one via
get_lab) - Get node definitions:
get_node_defsto know what's available - Plan the layout: Calculate x,y coordinates for visual placement
- Use a grid layout: 200px spacing horizontally, 200px vertically
- Group by role: core in center, edge on sides, servers at bottom
- Create nodes:
create_nodefor each device with meaningful labels - Create interfaces:
create_interfacefor each connection point - Wire links:
create_linkto connect interface pairs - Set conditions (if requested):
set_link_conditionfor WAN links - Add annotations:
create_annotationfor labels, IP addressing plans - Report the topology: List all nodes, interfaces, and links
Layout Guidelines
When placing nodes, use this visual grid approach:
Topology Layout (x, y coordinates):
Layer 0 (Top): Core routers y=100
Layer 1: Distribution y=300
Layer 2: Access / Leaf y=500
Layer 3 (Bottom): Servers / Endpoints y=700
x spacing: 200px between nodes in the same layer
Center the topology: start x at 100, distribute evenlyExample for a 2-spine, 4-leaf topology:
Spine1: (300, 100) Spine2: (500, 100)
Leaf1: (100, 300) Leaf2: (300, 300) Leaf3: (500, 300) Leaf4: (700, 300)
Srv1: (100, 500) Srv2: (300, 500) Srv3: (500, 500) Srv4: (700, 500)Link Conditioning
Use set_link_condition to simulate real-world WAN characteristics:
| Scenario | Bandwidth | Latency | Jitter | Loss |
|---|---|---|---|---|
| LAN | (none) | (none) | (none) | (none) |
| Metro Ethernet | 100 Mbps | 5 ms | 1 ms | 0% |
| WAN (good) | 50 Mbps | 20 ms | 5 ms | 0.1% |
| WAN (poor) | 10 Mbps | 100 ms | 20 ms | 1% |
| Satellite | 5 Mbps | 300 ms | 50 ms | 2% |
| Congested link | 1 Mbps | 200 ms | 100 ms | 5% |
Show full SKILL.md (281 more words)Show less
Workflow: Annotate Topology
After building a topology, add visual documentation:
- Title annotation: Lab name and purpose at the top
- IP addressing: Annotation blocks showing subnet assignments per link
- AS numbers: Label BGP AS boundaries
- Area labels: Mark OSPF areas, VRF names, VLAN IDs
- Notes: Any special instructions or test scenarios
Workflow: Simulate Link Failure
When testing network resilience:
- Get the link:
get_linksto find the link ID between the two nodes - Capture baseline: Use
execute_commandto check routing tables before failure - Bring link down:
set_link_statewith state "down" - Observe convergence: Execute show commands on affected nodes (OSPF neighbors, BGP summary, routing table)
- Optionally capture traffic: Use cml-packet-capture to capture reconvergence traffic
- Restore link:
set_link_statewith state "up" - Verify recovery: Confirm routing adjacencies re-establish
- Report: Document failover/failback time and behavior
Important Rules
- Always use
get_node_defsfirst to verify available node types before creating nodes - Create interfaces before links — you need interface IDs to wire links
- Use descriptive labels — "R1-Core" not "Node1"
- Plan before building — figure out the full topology before starting to create nodes
- Lab must be STOPPED to add nodes — cannot modify topology of a running lab
- Position nodes logically — hierarchical layout makes the topology readable in CML UI
- Record in GAIT — log topology creation for audit trail
Failure Behavior
- On a tool error (timeout, unreachable host, malformed response), report the failure and its error message directly to the user rather than fabricating or guessing at results.
- Do not automatically retry a write/mutating operation after a failure — surface the error and get explicit confirmation before retrying, since a blind retry on a partially-applied change can leave state inconsistent.
© automateyournetwork, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in workspace/skills/cml-topology-builder of automateyournetwork/netclaw.
Open the folder on GitHubat commit aa90e7d
Compare with similar skills
Cml Topology Builder next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Cml Topology Builder this skillautomateyournetwork/netclaw | 676 | — | ~1.8k | Automated safety check: Pass | Apache-2.0 | |
| Node Connectopenclaw/openclaw | 392k | — | ~1.6k | Automated safety check: Pass | MIT | |
| Node Inspect Debuggeropenclaw/openclaw | 392k | 1 repos | ~894 | Automated safety check: Pass | MIT | |
| Topology Authoringnetdata/netdata | 81k | — | ~3.9k | Automated safety check: Pass | GPL-3.0 | |
| Network Interface Healthaffaan-m/ECC | 277k | 1 repos | ~1.4k | Automated safety check: Pass | MIT | |
| Agent Topology Optimizerruvnet/ruflo | 74k | 2 repos | ~6.2k | Automated safety check: Pass | MIT |
Similar skills
Node Inspect Debugger
openclaw/openclaw
Debug Node.js with node inspect, --inspect, breakpoints, CDP, heap, and CPU profiles.
Topology Authoring
netdata/netdata
Design, change or review Netdata topology producers and netdata.topology.v1 payloads, including actors, links, evidence, correlation, presentation, modals, overlays and validators.
Network Interface Health
affaan-m/ECC
Diagnose interface errors, drops, CRCs, duplex mismatches, flapping, speed negotiation issues, and counter trends on routers, switches, and Linux hosts.
Agent Topology Optimizer
ruvnet/ruflo
Agent skill for topology-optimizer - invoke with $agent-topology-optimizer
Team Builder
affaan-m/ECC
Interactive picker that discovers available agent personas via the claude agents command and agents/ markdown globs, groups them into domains, has the user select up to five, dispatches them in…
More from automateyournetwork/netclaw
All 120 skills in this repoEVE-NG Lab Topology Design
automateyournetwork/netclaw
Entry point for designing EVE-NG network labs: classifies the request, gathers missing requirements, proposes options and validates the resulting topology.
ACI Policy Change Deployment
automateyournetwork/netclaw
Deploys Cisco ACI policy changes only behind an approved ServiceNow Change Request, capturing pre and post-change fault baselines and rolling back automatically on a fault delta.
Cisco ACI Fabric Health Audit
automateyournetwork/netclaw
Runs a phased health audit of a Cisco ACI fabric through MCP tools: node status, links, tenant and policy review, faults and endpoint learning.
Anta Validation
automateyournetwork/netclaw
Validate Arista EOS network state against ANTA's pre-built 208-test catalogue, with structured pass/fail verdicts.
Arista Cvp
automateyournetwork/netclaw
Arista CloudVision Portal (CVP) automation via REST API — device inventory, events, connectivity monitoring, tag management (4 tools).
AWS Cloud Monitoring
automateyournetwork/netclaw
AWS CloudWatch monitoring — metrics, alarms, log queries, VPC flow log analysis, network performance.
Questions about Cml Topology Builder
What does Cml Topology Builder do?
Build CML topologies — add nodes, create interfaces, wire links, set link conditioning, add annotations. Cml Topology Builder is an agent skill from automateyournetwork/netclaw. Build CML topologies — add nodes, create interfaces, wire links, set link conditioning, add annotations.
When should I use Cml Topology Builder?
Cml Topology Builder fits situations like: building a network topology in CML; switches to a lab; wiring links between nodes; simulating WAN conditions.
How do I install Cml Topology Builder in Claude Code?
Run `npx skills add automateyournetwork/netclaw --skill cml-topology-builder -a claude-code`. Or copy the skill folder (workspace/skills/cml-topology-builder in automateyournetwork/netclaw) into .claude/skills/cml-topology-builder in your project. Claude Code loads it when a task matches its description.
How do I install Cml Topology Builder in Codex?
Run `npx skills add automateyournetwork/netclaw --skill cml-topology-builder -a codex`. Or copy the skill folder (workspace/skills/cml-topology-builder in automateyournetwork/netclaw) into .agents/skills/cml-topology-builder in your project. Codex loads it when a task matches its description.
Can I use Cml Topology Builder in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add automateyournetwork/netclaw --skill cml-topology-builder -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cml-topology-builder, .gemini/skills/cml-topology-builder, .github/skills/cml-topology-builder and .opencode/skills/cml-topology-builder in your project.
What does Cml Topology Builder need to run?
Going by SKILL.md and its folder, Cml Topology Builder needs credentials named CML_PASSWORD.
Does Cml Topology Builder access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Cml Topology Builder safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Cml Topology Builder use?
Cml Topology Builder is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Cml Topology Builder use?
About 1.8k tokens (SKILL.md is roughly 7.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Cml Topology Builder?
Skills that share tags, products or a category with Cml Topology Builder: Node Connect (openclaw/openclaw, 392k stars), Node Inspect Debugger (openclaw/openclaw, 392k stars), Topology Authoring (netdata/netdata, 81k stars) and Network Interface Health (affaan-m/ECC, 277k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Cml Topology Builder?
automateyournetwork (a GitHub user) maintains it in automateyournetwork/netclaw, which has 676 GitHub stars. The repository holds 120 skills in this directory. The repository was last updated on October 9, 2026.
Source: automateyournetwork/netclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.