skill-doctor — 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

Instalação

Repositório do autor · Documentação oficial de Skills do Claude

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

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