amtiyo/mcp-troubleshooting
templates/agents/skills/mcp-troubleshooting/SKILL.md
Diagnose and fix MCP configuration/runtime issues across supported integrations using agents CLI checks.
$ install --global
skillsauthnpx skillsauth add amtiyo/agents mcp-troubleshootingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 18, 2026, 3:28 AM122.0s1 file scanned
SKILL.md
- name:
- mcp-troubleshooting
- description:
- Diagnose and fix MCP configuration/runtime issues across supported integrations using agents CLI checks.
When MCP servers are failing or not visible:
- Run
agents status --fastto inspect configured vs enabled integrations. - Run
agents mcp testfor schema/config validation. - Run
agents mcp test --runtimeto check integration CLI/runtime connectivity. - Run
agents doctorfor environment and binary diagnostics. - Apply the smallest safe fix, then run
agents syncand verify withagents sync --check.
Troubleshooting priorities:
- Missing binaries or PATH issues.
- Invalid server names/transport fields.
- Missing required environment variables or secrets.
- Target mismatch (server not routed to expected integration).
Related Skills
amtiyo/skill-guide
documentation
VerifiedTrustedCommunity
Explain how to create, organize, and maintain skills in .agents/skills when the user asks about skills.
64SKILL.mdUpdated May 18, 2026
amtiyo/docs-research
testing
VerifiedTrustedCommunity
Gather official, up-to-date documentation and convert it into a concise implementation checklist for the current coding task.
64SKILL.mdUpdated May 18, 2026
openclaw/taskflow
tools
VerifiedTrustedCommunity
Use when work should span one or more detached tasks but still behave like one job with a single owner context. TaskFlow is the durable flow substrate under authoring layers like Lobster, ACPX, plugins, or plain code. Keep conditional logic in the caller; use TaskFlow for flow identity, child-task linkage, waiting state, revision-checked mutations, and user-facing emergence.
357,764SKILL.mdUpdated Apr 10, 2026
openclaw/extensions/lobster
tools
VerifiedTrustedCommunity
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
357,764SKILL.mdUpdated Apr 10, 2026