BWBYB/agent-skills

Personal Skill Builder (Construtor de Skills Pessoais)

Crie skills pequenas e detectáveis que melhoram as decisões do agente para um fluxo de trabalho específico e repetível.

Escopo

Use este skill para uma nova skill ou para uma alteração focada em uma skill existente. Preserve a localização solicitada pelo usuário, a política de invocação e os limites de autorização. Não crie uma skill apenas para armazenar conselhos genéricos que o agente já conhece.

Fluxo de Trabalho

1. Defina o limite da tarefa antes de escrever arquivos:

   • Qual resultado repetível a skill oferece?
   • Quais solicitações devem ativá-la e quais solicitações semelhantes não devem?
   • Quais entradas, ferramentas, efeitos colaterais e verificações de conclusão são importantes?

2. Inspecione uma skill existente antes de alterá-la. Mantenha recursos e políticas úteis; não reinicialize um diretório existente.

3. Escolha a menor estrutura:

   • SKILL.md é obrigatório.
   • Adicione references/ apenas para material substancial e condicional que altere decisões.
   • Adicione scripts/ apenas para trabalho repetido ou determinístico onde a execução melhore a confiabilidade.
   • Adicione assets/ apenas para arquivos usados na saída gerada.

4. Escreva SKILL.md:

   • O name no frontmatter deve estar em minúsculas com hífen, corresponder ao diretório e ter no máximo 64 caracteres.
   • A description deve dizer o que a skill faz e quando se aplica; inclua um limite quando evitar roteamento incorreto.
   • Mantenha o corpo focado em resultados, regras não óbvias, ordem de execução, pontos de confirmação e verificações de conclusão.
   • Coloque detalhes condicionais em um recurso vinculado e indique exatamente quando lê-lo.

5. Valide o resultado com o validador de skill disponível quando o ambiente fornecer um (localize quick_validate.py no diretório do skill skill-creator instalado):

   python3 <skill-creator>/scripts/quick_validate.py /caminho/para/skill
   

   Se nenhum validador estiver disponível, execute as verificações equivalentes de frontmatter, nomenclatura, links de recursos, placeholders e scripts manualmente. Execute scripts adicionados quando prático.

Regras de Design

• Trate a descrição como uma condição de roteamento, não um catálogo de funcionalidades.
• Mantenha as instruções compartilhadas curtas o suficiente para carregamento rotineiro; não copie uma especificação externa inteira no ponto de entrada.
• Prefira escopo explícito e critérios de conclusão observáveis a proibições amplas ou adjetivos de qualidade vagos.
• Não adicione arquivos README, exemplos, modelos ou diretórios de recursos sem um fluxo de trabalho concreto que os utilize.
• Preserve os campos de frontmatter suportados existentes e os campos de agents/openai.yaml ao atualizar uma skill.
• Mantenha a descoberta automática ativada, a menos que o usuário solicite explicitamente invocação apenas explícita.

Referências

Leia a especificação Agent Skills quando portabilidade, campos de frontmatter, limites de nomenclatura ou comportamento de carregamento forem incertos. Trate qualquer guia de design fornecida pelo usuário ou local da máquina como uma fonte de preferência opcional: leia-a apenas quando o usuário solicitar explicitamente essas convenções ou a tarefa depender delas, e não copie seu conteúdo completo para a skill. Consulte um skill skill-creator instalado para detalhes de inicializador, metadados de UI ou validação, em vez de depender de um caminho absoluto específico da máquina.