SkillCheck

Visão Geral

Valida arquivos SKILL.md contra a especificação agentskills e as melhores práticas da Anthropic. Detecta erros estruturais, contradições semânticas, antipadrões de nomenclatura e lacunas de qualidade em uma única passagem somente leitura.

Quando Usar Esta Skill

• Use quando o usuário disser "verificar skill", "skillcheck" ou "validar SKILL.md"
• Use ao revisar uma skill antes de publicá-la em um marketplace
• Use ao depurar por que uma skill não está sendo acionada corretamente
• Use ao integrar uma equipe aos padrões de autoria de skills
• NÃO use para detecção de anti-slop, varredura de segurança ou análise de tokens; use SkillCheck Pro para isso

Como Funciona

Etapa 1: Analisar

Lê o arquivo SKILL.md alvo e extrai o frontmatter YAML.

Etapa 2: Validar

Aplica todas as verificações do nível Gratuito em ordem:

Etapa 3: Pontuar

Calcula a pontuação geral (0-100). Penalidades: crítica = -20, aviso = -5, sugestão = -1.

Etapa 4: Relatar

Retorna resultados estruturados: pontuação, nota (Excelente/Bom/Precisa de Trabalho/Ruim), lista de problemas com IDs de verificação, números de linha, mensagens e sugestões de correção.

Exemplos

Exemplo 1: Validando uma skill

User: check my skill at ~/.claude/skills/weekly-report/SKILL.md

SkillCheck output:
## weekly-report Check Results [FREE]

Score: 85/100 (Good)

### Warnings (2)
  - 1.2-desc-when (line 3): Description missing WHEN clause
  - 4.5-desc-no-triggers (line 3): Description lacks triggering conditions

### Suggestions (1)
  - 3.4-gerund-naming (line 2): Skill name could use gerund form

### Passed Checks: 28

Exemplo 2: Skill limpa passa em todas as verificações

User: skillcheck ~/.claude/skills/processing-pdfs/SKILL.md

Score: 100/100 (Excellent)
All 31 checks passed. No issues found.

Limitações

• Somente leitura: não modifica nenhum arquivo
• O nível gratuito cobre apenas verificações estruturais, semânticas e de nomenclatura
• Anti-slop, segurança, WCAG, token, enterprise e verificações de fluxo de trabalho exigem SkillCheck Pro
• Verificações semânticas (detecção de contradição, sabedoria/platitude) são heurísticas com taxa de ~5% de falsos positivos
• Não valida arquivos ou scripts referenciados; apenas verifica o conteúdo de SKILL.md
• Validação de arquivo único; não cruza com outras skills no mesmo diretório

Melhores Práticas

• Execute o SkillCheck antes de enviar skills para qualquer marketplace
• Corrija todos os problemas críticos e de aviso; sugestões são opcionais
• Use o ID da verificação (por exemplo, 1.2-desc-when) para encontrar a regra exata no corpo da skill
• Execute novamente após as correções para confirmar que a pontuação melhorou

Armadilhas Comuns

• Problema: Pontuação parece baixa devido a muitas sugestões Solução: Sugestões são limitadas a -15 pontos no total. Concentre-se em avisos e críticos primeiro.

• Problema: Falso positivo em termos ambíguos dentro de blocos de código Solução: SkillCheck ignora blocos de código e código inline. Se você ainda vir falsos positivos, coloque o termo entre crases.

• Problema: Verificação de sabedoria/platitude sinaliza instruções legítimas Solução: Reformule conselhos genéricos ("Lembre-se que testar é importante") como diretivas concretas ("Execute testes antes de confirmar").