Uma skill é uma pasta com um SKILL.md dentro: um cabeçalho YAML curto e instruções em Markdown. As instruções são a parte em que se gasta tempo, e a descrição é a parte que decide se essas instruções chegam a ser lidas. Ela é comparada com a tarefa em questão, então uma que diz do que a skill trata mas nunca diz quando recorrer a ela vai ficar sem uso indefinidamente — e sem nenhum erro que explique por quê. Este criador escreve o arquivo e confere esse campo com mais rigor: se nomeia um gatilho, se é longa o bastante para haver associação e se desperdiça as primeiras palavras. O nome é conferido contra as regras de nomes de pasta, e as instruções contra o tamanho abaixo do qual raramente mudam alguma coisa.
Recursos
Nome conferido contra as regras de pasta, com uma versão corrigida sugerida
Descrição conferida quanto à cláusula de gatilho — o que realmente provoca a associação
Avisa quando a descrição é curta demais para carregar sinal
Lista opcional de ferramentas permitidas, escolhida em vez de digitada
Uma pontuação que separa erros bloqueantes de sugestões
O caminho exato onde o arquivo deve ficar
Frontmatter com aspas corretas: dois-pontos na descrição não partem o valor
Baixa como SKILL.md, pronto para colocar no lugar
Como usar Construtor de skills
Nomeie a skill em minúsculas com hifens
Escreva uma descrição que diga o que faz e quando usar
Escreva as instruções em Markdown
Leia os achados e baixe o SKILL.md
Exemplo
Entrada
name: release-notes
Saída
description: Writes release notes from a range of git commits. Use when the user asks for a changelog.
A cláusula “Use quando…” é o que transforma um assunto em gatilho.
Erros comuns e solução de problemas
A skill parece nunca ser usada. — Quase sempre é a descrição. Ela precisa dizer quando se aplica, com as palavras que alguém usaria de verdade: tipos de arquivo, nomes de tarefa, frases que a pessoa digitaria.
O nome é rejeitado. — Ele também é o nome da pasta, então só aceita letras minúsculas, dígitos e hifens simples. Uma versão corrigida é sugerida quando o seu não serve.
Minha descrição tem dois-pontos e o arquivo quebra. — Não deveria: os valores recebem aspas quando precisam. Se editar o arquivo à mão depois, coloque entre aspas tudo que tenha dois-pontos seguidos de espaço.
A skill carrega mas não muda nada. — Instruções muito curtas raramente mudam o comportamento. Diga o que produzir, como trabalhar e o que não fazer.
Perguntas frequentes
O que faz uma boa descrição de skill?
Ela responde duas perguntas em uma ou duas frases: o que a skill faz e quando deve ser usada. A segunda metade é a que é comparada, então nomeie os tipos de arquivo, a tarefa e o jeito como as pessoas diriam. “Ajuda com documentos” não corresponde a nada em particular.
Onde o arquivo fica?
Em uma pasta com o nome da skill, dentro de um diretório de skills. O caminho aparece abaixo do editor e se atualiza enquanto você digita o nome. O nome da pasta e o do campo devem bater.
Devo definir uma lista de ferramentas permitidas?
Só quando a skill realmente precisar de menos ferramentas do que a sessão tem. Deixar vazia faz herdar o que estiver disponível, que costuma ser o desejado; restringir é um jeito de manter focada uma skill focada.
Que tamanho devem ter as instruções?
O suficiente para serem específicas e nada além. Poucas frases raramente mudam comportamento; várias páginas acabam sendo lidas por cima. Seções com títulos sobrevivem melhor à edição do que um bloco longo.
O arquivo é validado em algum outro lugar?
O carregador aceita tranquilamente um arquivo com descrição fraca — e esse é justamente o problema. Nada depois avisa que a skill é impossível de associar, e por isso a checagem cabe antes de você publicá-la.
Ferramentas relacionadas
Linter de skills — Cole um SKILL.md e veja o que impede que ele seja associado a uma tarefa.
Construtor de subagentes — Monte o arquivo de definição de um subagente com ferramentas e modelo.
Construtor de comandos — Crie um comando próprio, com argumentos e uma lista de ferramentas.