automateyournetwork/netclaw/catalyst-center-readonly

Claude Code and agent skill by automateyournetwork/netclaw

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Query Cisco Catalyst Center read-only — device inventory, site hierarchy, wireless, assurance health, compliance, software images, events. All 514 read-only API operations reachable through 8 grouped dispatchers. Use when asked what Catalyst Center manages, where a device sits, what its health or compliance state is, or to reconcile controller state against the devices themselves.

Install

npx vskill@latest install automateyournetwork/netclaw/catalyst-center-readonly

SKILL.md

The same SKILL.md was published earlier as automateyournetwork/netclaw/catalyst-center-readonly.

Catalyst Center (read-only)

Server

catc-mcp — a NetClaw client over Cisco's official tool catalogue (cisco-en-programmability/catc-mcp-oss, Apache-2.0, release/2.3.7.11). Strictly read-only: all 514 GET operations, the one mutating operation excluded. Manifest 1,821 tokens, where inlining every upstream tool would cost 64,420.

The 10 tools

Start with discovery — the catalogue is far too large to carry in the tool list:

ToolUse
catc_find(query, group, limit)Search all 514 operations by keyword or URI. Start here
catc_describe_operation(name)Full parameter schema for one operation

Then dispatch — catc_<group>(operation, params):

catc_devices · catc_sites · catc_wireless · catc_health · catc_compliance · catc_software · catc_events · catc_other

Operation names are not guessable. They are generated from Cisco's API spec — the device list is api_getSites-style naming, not getDeviceList. Always `catc_find` first. Guessing wastes a call and gets a refusal that names near-matches.

⚠ Two rules

1. An empty inventory is not an empty network

Zero devices means this controller manages none. It does not mean the network is empty. The causes are different and matter:

CauseWhat it means
Discovery has not rundevices exist, Catalyst Center has not found them
RBAC scopes the accountthe estate is larger than this account can see
The wrong applianceyou are asking a controller that manages nothing
A filter excluded everythingyour parameters, not the network
Genuinely nothing onboardedthe only case that is about the estate

This is not hypothetical. The two DevNet sandboxes share credentials and are not equivalent — sandboxdnac.cisco.com has 4 devices and 25 sites; sandboxdnac2.cisco.com has 0 devices and authenticates perfectly. An inventory answer from the second looks exactly like a real empty estate.

That is why every response names the appliance it came from, and why an empty result or a zero count carries an explicit caveat. Repeat the appliance name when you report a count, especially a zero.

2. "Catalyst Center says" is not "the device is"

reachabilityStatus is the controller's last polling result, not ground truth. A device shown Unreachable may be perfectly healthy and merely unreachable from the controller — a management-VRF problem, an ACL, a dead SNMP/NETCONF agent on an otherwise forwarding switch.

Catalyst Center is a database of what it last learned. A device can be listed and long dead, or absent and carrying traffic. Say when it was observed, and if the answer matters, confirm against the device with pyats or multivendor-cli.

Outcomes you will see

outcomeMeans
okrecords returned
emptythis controller returned nothing — see rule 1, never report as a network fact
unreachablethe appliance could not be reached. Not an empty result
auth_failedcredentials rejected or token expired. State is unknown, not empty
forbiddenRBAC denied it — and a related answer you did get may be scoped, not complete
not_configuredno appliance is configured at all
refusedunknown operation, or a missing path parameter

unreachable, auth_failed and empty are three different facts. Never collapse them.

Boundaries

Want to…Use
Read the device itselfpyats, multivendor-cli — when they disagree with the controller, the device is right
Intended statenetbox, nautobot — this is discovered state. A device here and not in NetBox is a reconciliation finding, not an error
Search Cisco documentationdevnet-catalyst-search — that reads docs; this queries an appliance
Wireless client experience over timethousandeyes, prometheus
Change anythingnothing here. Read-only; no mutation is reachable

Rules

  1. `catc_find` before dispatching. Operation names are generated, not guessable.
  2. Never report an empty result or zero count as a network fact. Name the appliance.
  3. Never say a device is down because Catalyst Center cannot reach it.
  4. State when the controller observed the data.
  5. `forbidden` on one call means other answers may be scoped. Say so.
  6. Read-only.

Security

  • Security scanPassed, 82 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
674
Repository forks
189
7-day trend score
33

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/automateyournetwork/netclaw/catalyst-center-readonly/badge)](https://verified-skill.com/skills/automateyournetwork/netclaw/catalyst-center-readonly)

Something wrong with this skill or its page? Tell us.