Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Topology Discovery · automateyournetwork | DecimalAI

devopsby automateyournetwork

Topology Discovery

automateyournetwork/pyats-topology

Source automateyournetwork/netclaw ↗License Apache-2.0

Network topology discovery via CDP/LLDP neighbors, ARP tables, routing peers, and interface mapping to build complete network maps.

SkillScore92Maintained

Automatic

DevOps & SRE pack

Last verified 8/16/2026

What it changes

Passed 21 of 23 test cases with the skill, and 5 of 23 without it.

Without skill20%

With skill92%

Checks it passed that the model alone missed

Invokes pyats_run_show_command for R1 with command show vrf
Executes pyats_run_show_command targeting R1 with command show arp
Invokes pyats_run_show_command for R1 with command show standby brief

and 17 more in the full report

18 fixed5 passed either way2 still failing0 broke

Pass-rate lift: +72 pp
Tokens: +71%
Agent turns: 0%
Response time: -41%

Model gemini-3.6-flashMeasured 8/16/2026v123 of 25 cases passed with skill · 23 comparable

Tokens, turns and time describe resource use, not a dollar price.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/automateyournetwork-pyats-topology/SKILL.md https://app.decimal.ai/s/automateyournetwork-pyats-topology/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add automateyournetwork-pyats-topology, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/automateyournetwork-pyats-topology/ and pins it in .decimal/skills.lock

decimalai skills add automateyournetwork-pyats-topology

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/automateyournetwork-pyats-topology/SKILL.md https://app.decimal.ai/s/automateyournetwork-pyats-topology/SKILL.md

Raw file: /s/automateyournetwork-pyats-topology/SKILL.md ↗ · machine-readable summary at /s/automateyournetwork-pyats-topology.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

See it in action

One of 18 test cases the skill fixed. Same model, same prompt, with and without the skill.

1 of 18

Prompt

Discovery found R1:Gi0/0/1 connected to SW1:Gi1/0/1, and NetBox dcim.cables has an identical matching cable entry. Categorize this link.

What was checked, without and with the skill
Checked	Without skill	With skill
Categorizes a link present in both discovery and NetBox as DOCUMENTED	Missed	Passed

case-22 · gemini-3.6-flash · 8/16/2026 · answers are capped and redacted

What's inside

The instructions your model reads when the skill loads.

SKILL.md193 linessingle file

Topology Discovery

When to Use

Building network diagrams from scratch (no documentation exists)
Validating existing documentation matches reality
Pre-change topology baseline
Incident response — understanding blast radius
New device onboarding — mapping where it connects

Discovery Procedure

Step 1: CDP Neighbors (Cisco-to-Cisco)

PYATS_TESTBED_PATH=$PYATS_TESTBED_PATH python3 $MCP_CALL "${PYATS_PYTHON:-python3} -u $PYATS_MCP_SCRIPT" pyats_run_show_command '{"device_name":"R1","command":"show cdp neighbors detail"}'

Extract per neighbor:

Device ID (hostname)
Platform and model
IP address (management address)
Local interface → Remote interface (link mapping)
Software version
Native VLAN (on switch links)
Duplex

Build adjacency table:

Local Device | Local Interface | Remote Device | Remote Interface | Remote Platform
R1           | Gi0/0/0         | SW1           | Gi1/0/1          | WS-C3850-24T
R1           | Gi0/0/1         | R2            | Gi0/0/0          | ISR4431

Step 2: LLDP Neighbors (Multi-Vendor)

PYATS_TESTBED_PATH=$PYATS_TESTBED_PATH python3 $MCP_CALL "${PYATS_PYTHON:-python3} -u $PYATS_MCP_SCRIPT" pyats_run_show_command '{"device_name":"R1","command":"show lldp neighbors detail"}'

Track record

Benchmark

21 / 23

test cases passed, vs 5 / 23 without

Adoption

Users: 0
Times used: 0

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/3/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

automateyournetwork / netclaw

workspace/skills/pyats-topology/SKILL.md

View on GitHub ↗

License Apache-2.0Imported 8/3/2026Version v1

More skills from the same source and nearby in the registry, with their headline benchmark lift.

Ready to supercharge your AI agents?

See it in action

What's inside

Topology Discovery

When to Use

Discovery Procedure

Step 1: CDP Neighbors (Cisco-to-Cisco)

Step 2: LLDP Neighbors (Multi-Vendor)

Track record

Benchmark

Adoption

SkillSafety

Source

Related skills