SKY-lv/skylv-skill-quality-assurance

Garantia de Qualidade de Skill

Analisa e pontua automaticamente a qualidade da documentação de skills do OpenClaw. Identifica problemas críticos e fornece correções acionáveis.

Visão Geral

Esta skill executa uma análise multidimensional de qualidade no arquivo SKILL.md de qualquer skill do OpenClaw, pontuando-a em:

• Clareza — Estrutura, cabeçalhos, comprimento de frases
• Completeza — Campos obrigatórios, seções de instalação/uso
• Acionabilidade — Guias passo a passo, comandos
• Descoberta — Palavras-chave, descrição, categorias
• Exemplos — Exemplos de código, antes/depois, casos de uso

Uso

Analisar uma única skill

Analise a skill em: C:\caminho\para\skills\minha-skill

Analisar todas as skills em um diretório

Execute: node engine.js C:\caminho\para\skills

Interpretação

Pontuação	Nota	Significado
8-10	A	Pronto para produção
6-7	B	Precisa de pequenas melhorias
4-5	C	Precisa de trabalho significativo
<4	F	Reescrita recomendada

Dimensões da Pontuação

1. Clareza (20%)

Verifica: hierarquia de cabeçalhos, comprimento de frases, palavras de preenchimento, formatação markdown

2. Completeza (20%)

Verifica: name, description, keywords, seção de instalação, seção de uso

3. Acionabilidade (25%)

Verifica: etapas numeradas, comandos executáveis, guias de configuração

4. Descoberta (15%)

Verifica: palavras-chave (5+), comprimento da descrição (50+ caracteres), categoria/tags

5. Exemplos (20%)

Verifica: blocos de código (3+), casos antes/depois, descrições de casos de uso

Limiares de Qualidade

Para publicação no ClawHub:

• Pontuação geral ≥ 7,0 necessária
• Nenhuma dimensão abaixo de 5,0
• Deve ter campo keywords
• Deve ter descrição ≥ 50 caracteres

Correção Automática

O script complementar fix_skill_md.cjs corrige automaticamente:

• Campo description ausente
• Campo keywords ausente
• Seção Install ausente
• Seção Usage ausente

node fix_skill_md.cjs

Exemplo de Saída

# Relatório de Qualidade da Skill

Analisadas: 34 skills

## Classificações Gerais
 1. ✅ skylv-browser-automation-agent   9,4/10
 2. ✅ skylv-openclaw-evomap-connector   9,3/10

Pontuação média: 8,1/10
Nota A (7+): 29
Nota B (5-6): 5
Nota C (<5): 0

Licença MIT © SKY-lv