O que skill-craft-adapter faz?
Plugin de avaliação de qualidade para Claude Code Skills — baseado em um framework de pontuação ponderada (8 módulos de verificação, 7 avaliações de antipadrões, 3 princípios de completude, portão de decisão), usado para avaliar, reparar, criar e auditar Claude Code Skills.
Funcionalidades
- Avaliação: Analisa skills existentes e atribui uma pontuação ponderada com base em 8 módulos de verificação (descrição, configuração, instruções, dependências, exemplos, nomenclatura, compatibilidade e documentação).
- Detecção de Antipadrões: Identifica 7 antipadrões comuns, como dependências frágeis, instruções ambíguas e duplicação de funcionalidades.
- Verificação de Completude: Aplica 3 princípios de completude (cobertura de casos de borda, tratamento de erros e documentação de saída).
- Portão de Decisão: Classifica a skill como 'aprovada', 'reprovada' ou 'necessita reparos' com base em um limite de pontuação configurável.
- Reparação Automática: Gera sugestões de correção para problemas identificados.
- Criação de Skills: Auxilia na criação de novas skills seguindo as melhores práticas definidas pelo framework.
- Auditoria: Gera relatórios detalhados de auditoria para todo o ciclo de vida da skill.
Requisitos
- Claude Code instalado e configurado.
- Node.js versão 18 ou superior.
- Acesso à internet para verificação de dependências externas.
Instalação
-
Clone o repositório:
git clone https://github.com/liaosw97/skill-craft-adapter.git cd skill-craft-adapter -
Instale as dependências:
npm install -
Configure as variáveis de ambiente (opcional):
export SKILL_CRAFT_THRESHOLD=80
Uso
Avaliar uma Skill
npx skill-craft-adapter evaluate --skill ./minha-skill
Criar uma Nova Skill
npx skill-craft-adapter create --name "minha-nova-skill" --description "Descrição da skill"
Auditar Skills
npx skill-craft-adapter audit --directory ./skills
Configuração
As seguintes variáveis de ambiente podem ser usadas para personalizar o comportamento:
| Variável | Descrição | Valor Padrão |
|---|---|---|
SKILL_CRAFT_THRESHOLD | Pontuação mínima para aprovação | 70 |
SKILL_CRAFT_STRICT | Modo estrito (falha em qualquer antipadrão) | false |
SKILL_CRAFT_LOG_LEVEL | Nível de log (debug, info, warn, error) | info |
Licença
MIT