Importação e gravação de skill

Duas formas de uma skill nascer sem alguém escrever o texto dela do zero: trazer de fora ou gravar o que acabou de ser feito.

Importar do GitHub

A importação acontece por dois caminhos — pela tela e pelo próprio agente, durante a conversa — e os dois passam pelo mesmo processo. O motivo é deliberado: validação, organização dos arquivos e mensagem de erro ficam iguais nos dois. Caminhos duplicados divergem, e a divergência só aparece no dia em que um deles aceita o que o outro recusa.

Entrada aceita: o endereço do repositório no GitHub, ou a forma curta com dono e nome, mais a pasta onde a skill está. O nome local pode ser trocado na hora; sem isso, vale o nome que a própria skill declara.

O que acontece em seguida: o conteúdo é buscado no GitHub, o texto da skill é analisado, os arquivos auxiliares sobem e a relação deles fica registrada.

Gravar a partir do que foi feito

Transforma um trecho de trabalho já realizado em uma skill. São dois passos, e eles acontecem numa conversa própria, que existe só para isso:

1. Perguntas — a partir do que foi feito, o sistema levanta o que precisa ser esclarecido para o procedimento servir de novo: o que era específico daquele caso e o que é regra geral.
2. Autoria — com as respostas, escreve a skill.

A descrição tem tamanho máximo, e não por economia: é ela que decide se a skill vai ser escolhida na hora certa, então precisa ser curta e dizer exatamente quando serve.

A ideia de fundo: o melhor momento de escrever um procedimento é logo depois de executá-lo, quando os detalhes ainda estão à mão. Gravar evita a documentação que ninguém escreve depois.

O que dá para fazer, e onde

Limites e cuidados

• Skill importada é instrução que o agente vai seguir. Trazer de um repositório público significa trazer texto que orienta o comportamento dele e, havendo auxiliares, arquivos que podem ser executados. Vale a mesma desconfiança que se tem com dependência de terceiro.
• O nome importado vira o endereço da skill na máquina do agente, então nome repetido merece atenção antes de importar.
• Já aconteceu de o texto chegar sem os arquivos que ele manda usar. Uma skill publicada pedia para executar um arquivo auxiliar que não veio junto no pacote. Quando a skill depende de auxiliares, confira que eles chegaram — o texto sozinho parece completo.