SkillSmith

O que SkillSmith faz?

Cria Skills para Agentes compatíveis com o padrão a partir de uma ideia de uma linha e faz lint em arquivos SKILL.md (regras de nome, tamanho da descrição e "quando usar", limite de compatibilidade, mapa de metadados, tamanho do corpo, segredos vazados). A CLI cli.js sem dependências, localizada na raiz do repositório SkillSmith, faz o trabalho.

Quando usar

• O usuário deseja uma nova skill para uma tarefa ("criar uma skill que…").
• O usuário deseja saber se uma pasta de skill ou SKILL.md segue o padrão, ou deseja corrigi-lo.

Passos

1. Para validar, execute node <caminho-para-skillsmith>/cli.js validate <diretório-da-skill> (várias pastas são permitidas). Código de saída 0 significa válido.
2. Relate cada error e corrija-os no SKILL.md do usuário: renomeie para nomes com hífen minúsculo, faça o nome da pasta corresponder a name, mantenha description com 1024 caracteres ou menos e inclua "Use quando …". Em seguida, execute novamente o passo 1.
3. Para criar uma skill, certifique-se de que GEMINI_API_KEY está definida (nunca a imprima), depois execute node <caminho-para-skillsmith>/cli.js new "<o que faz e quando usar>" --out <diretório-de-skills> --author "<nome>".
4. Mostre ao usuário o SKILL.md gerado e execute o passo 1 na nova pasta. Edite conforme necessário; a CLI nunca sobrescreve um SKILL.md existente.

Exemplos

• node cli.js validate skills/commitcraft skills/skillsmith
• node cli.js new "Resumir um arquivo CSV e sugerir gráficos. Use quando o usuário compartilhar um .csv" --out ./skills

Notas

• Campos de nível superior desconhecidos produzem um aviso; dados personalizados pertencem a metadata.
• A especificação recomenda um corpo com menos de 500 linhas; mova documentos longos para references/.