skill-doctor MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Valida frontmatter SKILL.md e metadados YAML
Detecta links quebrados e recursos de pacote ausentes
As pontuações acionam a descrição e a clareza das instruções
Valida o esquema evals/evals.json
Pontuação de 0 a 100 com descobertas acionáveis
Formatos de saída: texto, JSON, somente pontuação
Padrão de fluxo de trabalho integrado do GitHub Actions

Demo ao vivo

Como fica na prática

skill-doctor-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": {
    "skill-doctor-skill": {
      "command": "npx",
      "args": [
        "-y",
        "skill-doctor@latest",
        "."
      ],
      "_inferred": false
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "skill-doctor-skill": {
      "command": "npx",
      "args": [
        "-y",
        "skill-doctor@latest",
        "."
      ],
      "_inferred": false
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "skill-doctor-skill": {
      "command": "npx",
      "args": [
        "-y",
        "skill-doctor@latest",
        "."
      ],
      "_inferred": false
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "skill-doctor-skill": {
      "command": "npx",
      "args": [
        "-y",
        "skill-doctor@latest",
        "."
      ],
      "_inferred": false
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "skill-doctor-skill",
      "command": "npx",
      "args": [
        "-y",
        "skill-doctor@latest",
        "."
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "skill-doctor-skill": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "skill-doctor@latest",
          "."
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add skill-doctor-skill -- npx -y skill-doctor@latest .

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

Casos de uso

Usos do mundo real: skill-doctor

Lint sua habilidade antes de publicar em um mercado

👤 Autores de habilidades prestes a compartilhar um SKILL.md ⏱ ~15 min beginner

Quando usar: Você concluiu uma habilidade e deseja um passe de sanidade antes que alguém a instale.

Pré-requisitos

Nó 18+ — instalação nvm 18

Fluxo

Execute o médico

Execute o skill-doctor na raiz da habilidade.✓ Copiado

→ Pontuação + lista de descobertas por gravidade
Corrija itens de alta gravidade

Corrija primeiro os problemas de alta gravidade; repita até pontuação ≥ 85.✓ Copiado

→ A pontuação sobe; críticos desaparecem

Resultado: Uma habilidade que é ativada quando você espera e não possui referências quebradas.

Armadilhas

Perseguindo um 100 perfeito — Itens de baixa gravidade (lêndeas de estilo) geralmente são adequados; concentre-se em gatilhos e recursos

Combine com: oaustegard-claude-skills

Garanta um repositório de habilidades com uma pontuação de qualidade mínima em CI

👤 Equipes mantendo múltiplas habilidades em um repositório ⏱ ~30 min intermediate

Quando usar: Você envia habilidades com frequência e deseja prevenção de desvios.

Pré-requisitos

Ações do GitHub (ou equivalente) — Repositório com .github/workflows/

Fluxo

Adicione o fluxo de trabalho

Adicione um trabalho do GH Actions que execute o skill-doctor e falhe se a pontuação for < 80.✓ Copiado

→ Arquivo de fluxo de trabalho adicionado; funciona em relações públicas
Definir rigor por caminho

Habilidades de produção falham < 90; rascunhos permitem <70.✓ Copiado

→ Limites matriciais ou condicionais no fluxo de trabalho

Resultado: PRs que degradam a qualidade das habilidades são detectados antes da fusão.

Armadilhas

Travar a barra muito alta, muito cedo — Comece de forma permissiva, prolongue ao longo de 2 a 3 meses à medida que as descobertas forem corrigidas

Combine com: agent-skills-cli-skill

Diagnosticar por que uma habilidade não está sendo ativada

👤 Qualificar usuários com problemas de ativação ⏱ ~15 min beginner

Quando usar: Você instalou uma habilidade, mas Claude nunca a ativa.

Fluxo

Execute o médico no diretório de habilidades

Execute o skill-doctor em ~/.claude/skills/<skill>.✓ Copiado

→ As descobertas apontam para problemas de gatilho fraco ou de frontmatter
Edite a descrição

Reescreva a descrição para que as palavras-chave concretas da tarefa do usuário apareçam nela.✓ Copiado

→ Quedas na gravidade da clareza do gatilho

Resultado: Ativação mais clara; Claude escolhe a habilidade para as tarefas certas.

Combinações

Combine com outros MCPs para 10× de alavancagem

skill-doctor-skill + oaustegard-claude-skills

Lint antes de publicar no mercado

Execute o skill-doctor localmente; em seguida, abra um PR para oaustegard/claude-skills.✓ Copiado

skill-doctor-skill + agent-skills-cli-skill

Encadeie o Skill-Doctor com outras ferramentas de criação de habilidades

Use agent-skills-cli para estruturar; skill-doctor para validar antes de confirmar.✓ Copiado

skill-doctor-skill + claude-skill

Siga o guia de autoria e depois lint

Escreva de acordo com o guia de habilidades de Claude; verifique com o médico habilidoso.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
skill-doctor <path>	skill directory path	Antes de publicar, no CI ou para diagnosticar problemas de ativação	0

Custo e limites

O que custa rodar

Cota de API: Nenhum — análise estática local
Tokens por chamada: Nenhum (CLI, não uma API)
Monetário: Livre
Dica: Execute apenas em diretórios que foram alterados; no CI, use filtros de caminho para evitar a varredura de todo o repositório a cada PR.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Sem credenciais

Saída de dados: Nenhum — apenas análise local

habilidade-médico relata questões estruturais; não julga a segurança. Uma pontuação alta ≠ uma habilidade segura — ainda revise o que a habilidade pede para Claude fazer.

Solução de problemas

Erros comuns e correções

O médico diz que SKILL.md não foi encontrado

Execute a partir da raiz da habilidade (diretório que contém SKILL.md), não da raiz do repositório.

Verificar: ls SKILL.md in CWD

Falhas de esquema 'evals/evals.json'

Certifique-se de que cada avaliação tenha os campos obrigatórios; um esboço mínimo é melhor do que quebrado.

Verificar: jq . evals/evals.json

A pontuação não melhora após as edições

Execute novamente; se uma descoberta persistir, leia a gravidade e os detalhes — às vezes, as correções introduzem novos problemas de baixa gravidade.

Verificar: Diff the JSON reports between runs

Alternativas

skill-doctor vs. outros

Alternativa	Quando usar	Troca
agent-skills-cli-skill	Você deseja ferramentas CLI gerais para habilidades de andaime/gerenciamento	Conjunto de recursos diferente; não é um linter
claude-skill	Você deseja que o guia de autoria entenda o que é 'bom'	Documentos, não é um linter

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills