How do I install the Cisco Troubleshoot skill?

Run npx skillmds@latest add bradmccloskey/cisco-troubleshoot in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Cisco Troubleshoot safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Cisco Troubleshoot?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Cisco Troubleshoot free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Cisco Troubleshoot?

bradmccloskey (@bradmccloskey) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Cisco Troubleshoot by bradmccloskey

Name: Cisco Troubleshoot
Author: bradmccloskey

File contents

Cisco Network Troubleshooting Scripts

Write Python scripts for diagnosing and troubleshooting Cisco network issues. Follow these standards:

Troubleshooting Workflows

Layer 1 - Physical

Check interface status (up/down, err-disabled)
Detect CRC errors, input/output errors, collisions
Verify cable type and SFP module status
Check PoE status and power budget

Layer 2 - Data Link

MAC address table lookup and tracing
STP issues (root bridge, blocked ports, topology changes)
VLAN mismatch detection (native VLAN, allowed VLANs)
EtherChannel member state and load balancing
CDP/LLDP neighbor mapping

Layer 3 - Network

Routing table analysis and path tracing
OSPF neighbor stuck states, MTU mismatches
BGP session diagnostics (state, prefix counts, route filtering)
EIGRP stuck-in-active detection
ARP table analysis, duplicate IP detection
MTU path discovery

Security

ACL hit analysis (which rules are matching)
NAT translation table diagnostics
VPN tunnel debugging (Phase 1/Phase 2 state)
Port security violations
DHCP snooping / Dynamic ARP Inspection issues

Performance

Interface utilization trending
QoS policy verification and queue stats
CPU and memory utilization collection
Top talkers via NetFlow data

Script Patterns

# Troubleshooting scripts should:
# 1. Collect relevant show commands
# 2. Parse output into structured data
# 3. Apply diagnostic logic (rules/thresholds)
# 4. Present findings with severity levels
# 5. Suggest remediation commands where possible

Libraries to Use

netmiko for command execution
pyats + genie for structured parsing (preferred)
textfsm / ttp as parsing alternatives
rich for colored severity output (CRITICAL/WARNING/INFO)
networkx for topology analysis if needed

Output Format

Use severity levels: CRITICAL, WARNING, INFO
Show the diagnostic finding and supporting evidence
Suggest specific CLI commands to remediate
Include raw command output in verbose/debug mode

---name: cisco-troubleshootdescription: Generate Python scripts for troubleshooting Cisco network issues. Use when the user needs to diagnose connectivity problems, protocol issues, performance problems, or collect diagnostic data from Cisco devices.---## Cisco Network Troubleshooting ScriptsWrite Python scripts for diagnosing and troubleshooting Cisco network issues. Follow these standards:### Troubleshooting Workflows#### Layer 1 - Physical- Check interface status (up/down, err-disabled)- Detect CRC errors, input/output errors, collisions- Verify cable type and SFP module status- Check PoE status and power budget#### Layer 2 - Data Link- MAC address table lookup and tracing- STP issues (root bridge, blocked ports, topology changes)- VLAN mismatch detection (native VLAN, allowed VLANs)- EtherChannel member state and load balancing- CDP/LLDP neighbor mapping#### Layer 3 - Network- Routing table analysis and path tracing- OSPF neighbor stuck states, MTU mismatches- BGP session diagnostics (state, prefix counts, route filtering)- EIGRP stuck-in-active detection- ARP table analysis, duplicate IP detection- MTU path discovery#### Security- ACL hit analysis (which rules are matching)- NAT translation table diagnostics- VPN tunnel debugging (Phase 1/Phase 2 state)- Port security violations- DHCP snooping / Dynamic ARP Inspection issues#### Performance- Interface utilization trending- QoS policy verification and queue stats- CPU and memory utilization collection- Top talkers via NetFlow data### Script Patterns```python# Troubleshooting scripts should:# 1. Collect relevant show commands# 2. Parse output into structured data# 3. Apply diagnostic logic (rules/thresholds)# 4. Present findings with severity levels# 5. Suggest remediation commands where possible```### Libraries to Use- `netmiko` for command execution- `pyats` + `genie` for structured parsing (preferred)- `textfsm` / `ttp` as parsing alternatives- `rich` for colored severity output (CRITICAL/WARNING/INFO)- `networkx` for topology analysis if needed### Output Format- Use severity levels: CRITICAL, WARNING, INFO- Show the diagnostic finding and supporting evidence- Suggest specific CLI commands to remediate- Include raw command output in verbose/debug mode

Frequently asked questions

Cisco Troubleshoot