/ Diretório / Playground / Debug Skill
● Comunidade AlmogBaku ⚡ Instantâneo

Debug Skill

por AlmogBaku · AlmogBaku/debug-skill

Real-debugger skill: breakpoints, stepping, variable inspection.

Most agents 'debug' by printing. This skill actually attaches a debugger (delve, debugpy, gdb) and exposes step/continue/inspect to Claude. Useful for nasty bugs where 'add a log' loops forever.

Por que usar

Principais recursos

Demo ao vivo

Como fica na prática

debug-skill.replay ▶ pronto
0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "debug-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AlmogBaku/debug-skill",
        "~/.claude/skills/debug-skill"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "debug-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AlmogBaku/debug-skill",
        "~/.claude/skills/debug-skill"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "debug-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AlmogBaku/debug-skill",
        "~/.claude/skills/debug-skill"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "debug-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AlmogBaku/debug-skill",
        "~/.claude/skills/debug-skill"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "debug-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AlmogBaku/debug-skill",
        "~/.claude/skills/debug-skill"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json
{
  "context_servers": {
    "debug-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/AlmogBaku/debug-skill",
          "~/.claude/skills/debug-skill"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add debug-skill -- git clone https://github.com/AlmogBaku/debug-skill ~/.claude/skills/debug-skill

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Debug Skill

Find the nil deref a print loop can't catch

👤 Backend devs ⏱ ~15 min intermediate

Quando usar: A specific input causes a panic and you can't see where without a debugger.

Pré-requisitos
  • Server/skill installed and authenticated — See repo README
Fluxo
  1. Reproduce under debugger
    Using the debug skill, run main_test.go::TestPanicCase under delve with a breakpoint at the panic frame.✓ Copiado
    → Process paused at the panic
  2. Inspect
    Print locals and the call chain. Show me which variable is nil.✓ Copiado
    → Variable value + caller chain

Resultado: Bug located, not guessed.

Armadilhas
  • Breakpoints by symbol can match multiple methods in Go interfaces — Breakpoints by symbol can match multiple methods in Go interfaces — qualify with the package path.

Custo e limites

O que custa rodar

Cota de API
See provider docs for rate limits
Tokens por chamada
Varies by tool
Monetário
See repo README for pricing details
Dica
Cache tool results and avoid repeated identical calls.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Use environment variables; never commit secrets
Saída de dados: Tool calls go to the provider's API as documented

Solução de problemas

Erros comuns e correções

delve not found

Install delve: go install github.com/go-delve/delve/cmd/dlv@latest.

Verificar: dlv version
debugger detaches randomly

Long pauses can hit the IDE's heartbeat. Use the skill's --no-heartbeat option for slow flows.

Verificar: Set the flag and retry

Alternativas

Debug Skill vs. outros

AlternativaQuando usarTroca
ad-hoc print debuggingTrivial bugsFaster setup; doesn't scale to hard bugs

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills