Pacote de Habilidade Pública
Execute o pipeline de liberação que transforma uma habilidade privada em uma versão pública no GitHub. A ordem do pipeline é fixa: avaliar → limpar → documentar → tematizar → empacotar → registrar. Não pule a etapa de limpeza. Nada é enviado com achados de limpeza não resolvidos.
1. Avaliar
Responda às quatro perguntas em registry/pipeline.md (vale a pena instalar? independente?
lavável? explicável em uma página?). Qualquer "não" → pare, relate o bloqueador, mantenha
a habilidade privada. Registre o veredito no catálogo.
2. Limpar
Execute o scanner e resolva todos os achados antes de continuar:
python3 scripts/scrub_personal.py <diretório-da-habilidade>
- Substitua caminhos pessoais por genéricos (
/Users/voce/...,<seu-projeto>/). - Substitua nomes/e-mails pessoais pelo contato público da marca ou um placeholder.
- Remova credenciais diretamente — nunca coloque na lista de permissões um segredo real.
- Execute novamente até o código de saída 0. Use
--allowapenas para strings públicas intencionais (ex.: o nome da marca).
3. Documentar
Copie de references/ para a raiz da habilidade candidata e preencha todos os placeholders:
readme-template.md→README.md(problema, instalação, uso, licença)changelog-template.md→CHANGELOG.md, primeira entrada## [1.0.0] - <hoje>- Adicione
LICENSE— o proprietário escolhe por versão (aberta ou comercial). Nunca declare uma licença ou preço em qualquer página pública que o repositório não inclua de fato.
4. Tematizar a página web
Copie assets/site-template/ para a pasta de site da versão e substitua os
tokens {{PLACEHOLDER}} (nome da habilidade, tagline, URL do repositório, funcionalidades, comando
de instalação). Não altere a paleta, fontes ou regras de layout — o comentário de cabeçalho
em styles.css documenta as diretrizes da marca (sem destaques amarelos, sem bolhas de brilho,
sem texto dourado sobre azul marinho, fonte script apenas para acentos).
5. Empacotar
Valide a estrutura (frontmatter do SKILL.md tem name + description; apenas
recursos scripts/, references/, assets/ que realmente existem), depois compacte:
cd <pai-de-encenação> && zip -r <nome-da-habilidade>.skill <nome-da-habilidade>
6. Registrar e catalogar
- Mova a pasta limpa + o arquivo
.skill+ a página web parareleases/<nome-da-habilidade>/. - Atualize o status em
registry/pipeline.mde oCHANGELOG.mddo projeto. - Relate: o que foi enviado, resultados da limpeza, etapas manuais restantes (git init, criação de repositório no GitHub, push — estas precisam da aprovação e credenciais do proprietário).
Consulte references/release-checklist.md para a lista de verificação completa pré-lançamento;
percorra-a antes de declarar qualquer versão como concluída.