automateyournetwork/netclaw/catalyst-center-readonly
Claude Code and agent skill by automateyournetwork/netclaw
- community
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-readonlySKILL.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:
| Tool | Use | |
|---|---|---|
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:
| Cause | What it means | |
|---|---|---|
| Discovery has not run | devices exist, Catalyst Center has not found them | |
| RBAC scopes the account | the estate is larger than this account can see | |
| The wrong appliance | you are asking a controller that manages nothing | |
| A filter excluded everything | your parameters, not the network | |
| Genuinely nothing onboarded | the 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
outcome | Means | |
|---|---|---|
ok | records returned | |
empty | this controller returned nothing — see rule 1, never report as a network fact | |
unreachable | the appliance could not be reached. Not an empty result | |
auth_failed | credentials rejected or token expired. State is unknown, not empty | |
forbidden | RBAC denied it — and a related answer you did get may be scoped, not complete | |
not_configured | no appliance is configured at all | |
refused | unknown 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 itself | pyats, multivendor-cli — when they disagree with the controller, the device is right | |
| Intended state | netbox, nautobot — this is discovered state. A device here and not in NetBox is a reconciliation finding, not an error | |
| Search Cisco documentation | devnet-catalyst-search — that reads docs; this queries an appliance | |
| Wireless client experience over time | thousandeyes, prometheus | |
| Change anything | nothing here. Read-only; no mutation is reachable |
Rules
- `catc_find` before dispatching. Operation names are generated, not guessable.
- Never report an empty result or zero count as a network fact. Name the appliance.
- Never say a device is down because Catalyst Center cannot reach it.
- State when the controller observed the data.
- `forbidden` on one call means other answers may be scoped. Say so.
- 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
- SKILL.md in the repositoryCheckingworkspace/skills/catalyst-center-readonly/SKILL.md
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
[](https://verified-skill.com/skills/automateyournetwork/netclaw/catalyst-center-readonly)