Communitygithub.com

sayed3li97/skillscore

Analisa e pontua qualquer SKILL.md de agente de IA com base nos guias oficiais de criação do Claude, Codex e Antigravity — CLI Dart offline.

O que é skillscore?

O skillscore é uma ferramenta de linha de comando (CLI) escrita em Dart que permite lintar e pontuar arquivos SKILL.md de agentes de IA de forma offline. Ele verifica a conformidade do conteúdo com os guias oficiais de redação do Claude, Codex e Antigravity, garantindo que as habilidades dos agentes sigam as melhores práticas e padrões recomendados. Desenvolvido por sayed3li97, este utilitário é especialmente útil para desenvolvedores que criam skills para plataformas como Claude Code, Cursor, Codex ou outras ferramentas de agentes de IA, ajudando a identificar inconsistências, erros de formatação ou desvios das diretrizes oficiais. Ao executar skillscore em um SKILL.md, o usuário recebe uma pontuação detalhada e sugestões de melhoria, tudo processado localmente sem necessidade de conexão com a internet.

Funciona com✓Claude Code✓Codex CLI~Cursor✓Antigravity
npx skills add sayed3li97/skillscore

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que skillscore faz?

Analisa e pontua qualquer SKILL.md de agente de IA com base nos guias oficiais de criação do Claude, Codex e Antigravity — CLI Dart offline.

Funcionalidades

  • Lintagem completa: Verifica a estrutura, formatação e conteúdo do SKILL.md conforme os guias oficiais.
  • Pontuação automática: Atribui uma nota com base na conformidade com os padrões.
  • Suporte multi-plataforma: Compatível com skills para Claude, Codex e Antigravity.
  • Offline: Processa tudo localmente, sem depender de APIs externas.
  • Feedback detalhado: Fornece sugestões específicas para corrigir problemas encontrados.

Como usar

dart run skillscore caminho/para/SKILL.md

Flags

  • --help Mostra esta mensagem de ajuda.
  • --version Exibe a versão da ferramenta.
  • --platform <claude|codex|antigravity> Define o guia a ser usado (padrão: todos).

Exemplo de saída

Arquivo: SKILL.md
Pontuação: 85/100

Problemas encontrados:
- Seção 'Descrição' muito curta (2 palavras, mínimo 10).
- Falta a seção 'Exemplos de uso'.

Sugestões:
- Expanda a descrição para incluir detalhes sobre o funcionamento da skill.
- Adicione exemplos práticos de como utilizar a skill.

Guias suportados

Instalação

Certifique-se de ter o Dart SDK instalado (versão 2.17 ou superior). Depois, execute:

dart pub global activate skillscore

Licença

MIT

Habilidades Relacionadas