Gentleman-Programming/gentle-ai-skill-creator

Contrato de Ativação

Use este skill ao criar ou atualizar um skill de IA reutilizável para Pi ou outro runtime de agente.

Crie um skill quando:

• um fluxo de trabalho ou convenção é reutilizado entre sessões;
• o comportamento genérico do agente precisa de restrições específicas do projeto;
• uma árvore de decisão ajuda o agente a escolher com segurança;
• exemplos, modelos ou referências tornariam a execução futura mais confiável.

Não crie um skill para uma tarefa única, documentação genérica ou regras que pertencem ao código/testes.

Regras Rígidas

• Siga docs/skill-style-guide.md como a fonte normativa para estrutura e estilo do skill.
• Um skill é um contrato de runtime LLM, não uma documentação voltada para humanos.
• Mantenha SKILL.md conciso: aponte para 180–450 tokens, máximo 1000.
• Use instruções imperativas e portões concretos; evite tutoriais e texto de fundo.
• A description do frontmatter deve ser uma linha fisicamente segura para YAML e incluir palavras-gatilho primeiro.
• Não adicione uma seção Keywords; coloque as palavras-gatilho essenciais na description.
• Coloque modelos, esquemas e exemplos gerados em assets/.
• Coloque justificativas mais longas ou links de documentação local em references/.
• Após alterar skills do projeto, atualize o registro com /skill-registry:refresh quando disponível.

Portões de Decisão

Necessidade	Ação
Comportamento pequeno reutilizável	Crie apenas skills/{skill-name}/SKILL.md
Modelos, esquemas, fixtures	Adicione skills/{skill-name}/assets/
Explicação mais longa ou casos extremos	Adicione skills/{skill-name}/references/
Skill existente cobre o assunto	Atualize o skill existente
Skill afeta descoberta de delegação	Garanta que palavras-gatilho apareçam na description

Passos de Execução

1. Leia docs/skill-style-guide.md antes de criar ou atualizar skills.
2. Inspecione skills existentes e confirme que o novo skill não duplica nenhum.
3. Escolha um nome de skill em kebab-case que corresponda ao gatilho voltado ao usuário.
4. Crie ou atualize esta estrutura:

skills/{skill-name}/
├── SKILL.md
├── assets/       # opcional
└── references/   # opcional

5. Use este formato de frontmatter:

---
name: {skill-name}
description: "Gatilho: {frases que usuários ou agentes dirão}. {O que este skill faz}."
license: Apache-2.0
metadata:
  author: gentleman-programming
  version: "1.0"
---

6. Escreva as seções nesta ordem: Contrato de Ativação, Regras Rígidas, Portões de Decisão, Passos de Execução, Contrato de Saída, Referências.
7. Se este for um skill empacotado como gentle-pi, adicione-o a scripts/verify-package-files.mjs.
8. Atualize ou documente o caminho de atualização do registro de skills.

Contrato de Saída

Retorne:

• Arquivos criados ou modificados.
• Se isto criou um novo skill ou atualizou um existente.
• Quaisquer arquivos de suporte assets/ ou references/ adicionados.
• Se a verificação de pacote ou atualização do registro de skills é necessária.

Referências

• docs/skill-style-guide.md — guia de estilo normativo para skills primários para LLM.
• skills/skill-registry/SKILL.md — contrato de atualização e indexação do registro.