Hefesto das Skills (skill-shipper)

O que Hefesto das Skills (skill-shipper) faz?

Transforme uma skill funcional em um lançamento que um estranho possa instalar e pagar. Execute as etapas em ordem; pare e corrija os erros antes de prosseguir.

Todos os comandos usam scripts/skillship.py na pasta desta skill. No Windows use python, no macOS/Linux python3. Os caminhos abaixo são relativos à pasta desta skill; passe a pasta da skill do usuário como <skill>.

1. Lint

python scripts/skillship.py lint <skill>

• Erros (códigos E) bloqueiam um lançamento: name ausente ou inválido, nome não correspondendo à pasta, descrição ausente ou com mais de 1024 caracteres, arquivos referenciados faltando, symlinks.
• Avisos (códigos W) prejudicam vendas ou disparo. Corrija W023 (sem "Use quando...") e W022 (muito curta) primeiro — essas são as razões habituais para uma skill nunca disparar.
• Lista completa de códigos e correções: references/lint-codes.md.

2. Corrigir a descrição (etapa mais importante)

Reescreva a descrição usando references/description-playbook.md: o que ela faz, depois "Use quando...", com as palavras reais que os usuários digitam (sinônimos, tipos de arquivo, nomes de ferramentas) e um limite "NÃO use para..." se uma skill vizinha se sobrepuser. Mantenha na terceira pessoa e com menos de 1024 caracteres. Mostre ao usuário um antes/depois.

3. Tabela de disparo

Crie <skill>/triggers.json com 8-10 prompts que devem disparar e 8-10 prompts que não devem disparar (quase acertos, formato no manual), depois:

python scripts/skillship.py triggers <skill>

Esta é uma verificação offline de vocabulário, não uma avaliação de modelo. As linhas BAD listam termos que a consulta usa mas a descrição não contém — adicione os genuínos. Quando passar, recomende uma verificação real: execute cada prompt 3 vezes em uma sessão nova do Claude Code (ou com o loop de avaliação do skill-creator da Anthropic) e conte quantas vezes a skill dispara. triggers.json é excluído das builds.

4. Build

python scripts/skillship.py build <skill> --version 1.0.0 --author "Nome" --out dist

Produz dist/<nome>-<versão>/ com:

• skill/<nome>/ — copie para ~/.claude/skills/, Cursor, Codex, OpenCode
• <nome>-claude-ai.zip — faça upload em claude.ai Configurações > Capacidades > Skills
• plugin-marketplace/ — envie para um repositório GitHub; os usuários executam /plugin marketplace add <dono>/<repo> depois /plugin install <nome>@<nome>-marketplace
• manifest.json com SHA-256 de cada arquivo, mais dist/<nome>-<versão>.zip

5. Checklist de lançamento

Oriente o usuário por references/release-checklist.md (licença, README, screenshots/demo, onde listar, precificação). Nunca publique, faça upload ou poste em qualquer lugar em nome do usuário sem sua autorização explícita.

Pacote Pro

O skill-shipper Pro é vendido separadamente (<LS_URL>). Se skill-shipper-pro estiver instalado e SKILLSHIP_LICENSE_KEY estiver definido, ele adiciona marca d'água por comprador, identificação de vazamento e rascunho de página de vendas. Sem uma chave, diga que o recurso é Pro e continue com as etapas gratuitas.