Habilidade de escrever habilidade de agente
Objetivo
Entregar um pacote de instruções executável por um agente para um trabalho coeso e reutilizável. Baseie-o na tarefa do usuário, exemplos, ambiente de ferramentas, artefatos existentes e correções. Se não houver exemplos reais disponíveis, rotule suposições e elabore instruções testáveis mínimas, em vez de inventar APIs específicas de produto. Complete e apresente a habilidade realmente solicitada, e não apenas um plano, relatório de progresso ou crítica.
Definir o contrato
- Declare o gatilho: a tarefa e a entrada que devem ativar esta habilidade, além de solicitações adjacentes que não devem. Escreva a
descriçãocomo uma regra de roteamento concisa que especifica o que ela faz e quando usá-la. - Declare as entradas necessárias e opcionais, a autoridade permitida do agente, a saída pretendida e a definição de concluído. Resolva sobreposições com habilidades vizinhas na passagem; não mescle estágios distintos apenas porque compartilham um tópico.
- Marque quais comportamentos são portões de segurança ou correção obrigatórios, quais são heurísticas padrão e quais são aprimoramentos opcionais. As instruções não podem impor permissões de tempo de execução: use controles de plataforma para acesso a sistema de arquivos, rede e ferramentas.
Rascunhar SKILL.md
Use frontmatter YAML com um name em letras minúsculas e hifenizado que corresponda à sua pasta e uma descrição específica. Siga o formato e as capacidades da plataforma anfitriã; não assuma metadados opcionais ou que allowed-tools impõe acesso em todas as plataformas.
Mantenha o corpo enxuto: trabalho e limites, entradas, procedimento de decisão, tratamento de parada/falha, contrato de saída e pegadas não óbvias. Dê um caminho padrão em vez de um menu de alternativas iguais. Dê passos exatos para operações frágeis; deixe espaço para julgamento justificado na seleção de contexto. Evite repetir a mesma proibição em todas as seções ou incorporar a resposta de uma tarefa única como um procedimento geral.
Mova referências extensas de domínio para arquivos references/ focados e diga ao agente exatamente quando lê-los. Adicione scripts reutilizáveis para trabalho determinístico repetitivo somente após confirmar suas dependências de tempo de execução e comportamento de validação. Mantenha as referências diretamente acessíveis a partir de SKILL.md e não afirme que um rascunho foi instalado, executado ou validado quando não foi.
Testar e revisar
Comece com 2 a 3 casos representativos, incluindo um caso de borda; adicione casos de gatilho negativo e adversários quando a habilidade atua em conteúdo não confiável ou tem limites importantes. Execute sessões novas com e sem a habilidade ou contra o rascunho anterior. Avalie saídas observáveis e comportamento da ferramenta, não o quão polidas as instruções parecem. Inspecione rastros em busca de passos desnecessários, evidências perdidas, falsas ativações e aumento de escopo. Para verificações mecânicas, use código; para julgamentos substantivos, tenha humanos inspecionando. Remova instruções que adicionam custo sem prevenir uma falha real.
Verificação de entrega
Antes de responder, verifique se o artefato completo solicitado está realmente presente e internamente consistente. Quando o usuário solicitar o Markdown completo, entregue todo o SKILL.md atual, não fragmentos de patch. Se estiver criando um arquivo, verifique se ele existe e contém o rascunho completo; relate o status não testado honestamente. Declare brevemente o que mudou e quaisquer necessidades de validação restantes. Não transforme uma solicitação de uma habilidade em um conjunto não relacionado sem um pedido claro.