Debug

Debug issues in the MCP Gateway Registry using first-principles thinking. Invoke when something is broken, timing out, returning errors, or behaving unexpectedly. Forces structured root-cause analysis before any code change is proposed.

1,052 stars 263 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add agentic-community/mcp-gateway-registry --skill debug
Manual install
git clone --depth 1 https://github.com/agentic-community/mcp-gateway-registry.git /tmp/mcp-gateway-registry
mkdir -p ~/.claude/skills
cp -r /tmp/mcp-gateway-registry/.claude/skills/debug ~/.claude/skills/debug

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Debug Skill

Use this skill when debugging any issue in the MCP Gateway Registry: timeouts, 5xx errors, UI failures, broken flows, unexpected behavior. Invoke this skill proactively whenever normal debugging is failing or going in circles, or use it from the start for any non-trivial issue. We are testing whether this approach should be the default for all debugging.

## Expert Personas

Before starting, announce that you are consulting the following expert panel. Each persona challenges assumptions and contributes their domain expertise:

- **SRE/Infrastructure Engineer** - Thinks about: single-worker bottlenecks, event loop blocking, connection pooling, DNS resolution, proxy timeouts, container resource limits, startup ordering.
- **Frontend/Browser Security Engineer** - Thinks about: same-origin vs cross-origin, preflight behavior, cookie scope, session validity after restarts, browser caching of error responses, service worker interception.
- **Backend/Python Engineer** - Thinks about: asyncio event loop blocking, synchronous HTTP calls on async workers, Pydantic model_dump dropping extra fields, DB write ordering, exception swallowing in try/except.
- **Senior Staff Engineer (Skeptic)** - Questions EVERY theory before implementation. Asks: "If that were true, why does X work?" and "Was this working before our change?" Forces the team to prove hypotheses before writing code.
Read the full skill on GitHub

Details

Skill name
debug
Path
.claude/skills/debug/SKILL.md
License
Apache-2.0
Repo updated
18 November 2026

FAQ

What does the Debug skill do?

Debug issues in the MCP Gateway Registry using first-principles thinking. Invoke when something is broken, timing out, returning errors, or behaving unexpectedly. Forces structured root-cause analysis before any code change is proposed.

How do I install the Debug skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add agentic-community/mcp-gateway-registry --skill debug. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Debug popular?

It lives in agentic-community/mcp-gateway-registry, which has 1,052 GitHub stars and 263 forks.

Related skills

Agentcore Register

1.1k

agentic-community/mcp-gateway-registry

Given an MCP server URL, probe the server via curl to discover its metadata and tools, then generate a markdown file with copy-pasteable content for each field in the Amazon Bedrock AgentCore "Create record" form.

AI, LLMs & Agents263

Benchmark Report

1.1k

agentic-community/mcp-gateway-registry

Generate a benchmark report from stress test results (registration, API performance, search concurrency). Reads JSON result files and produces a markdown report suitable for docs/benchmarks/.

Testing & QA263

Create Milestone

1.1k

agentic-community/mcp-gateway-registry

Create a GitHub milestone for an upcoming release. Suggests the next version based on the latest release, gathers all merged PRs and closed issues since that release, presents a draft with two tables (Issues and PRs) for user approval, then creates the milestone and assigns all approved items.

Git & Code Review263

Antigravity Skills Manager

2k

rmyndharis/antigravity-skills

Searches, installs, updates, and lists skills from the Antigravity Skill Vault. Use when choosing or managing workspace or global skills through the npm CLI.

Software Development295

Springboot Patterns

2k

xu-xiang/everything-claude-code-zh

Spring Boot 架构模式、REST API 设计、分层服务、数据访问、缓存、异步处理与日志。适用于 Java Spring Boot 后端开发。

Software Development332

API Testing Observability API Mock

2k

rmyndharis/antigravity-skills

Design realistic API mock services that simulate real API behavior for development, testing, and demos, enabling parallel development. Use when a team needs mocks for an API that is unavailable, unstable, or still being built.

Software Development295

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.