CommunityEscrita e Ediçãogithub.com

write-agent-skill

Projetar, redigir, revisar ou auditar pacotes de instruções reutilizáveis de habilidades de IA agente e SKILL.md. Use ao criar ou melhorar o escopo, descrição do gatilho, fluxo de trabalho, referências ou scripts de suporte, limites de segurança e avaliações de uma habilidade; adapte a habilidade ao agente anfitrião e às tarefas reais.

O que é write-agent-skill?

Esta habilidade, chamada 'write-agent-skill', foi projetada para agentes de IA como Claude Code, Cursor ou Codex criarem, refinarem ou auditarem pacotes de habilidades reutilizáveis. Ela define um processo completo que começa pela compreensão do problema do usuário, coleta de exemplos e definição de um contrato claro (gatilho, entradas, saídas, limites de segurança). Em seguida, orienta a redação do arquivo SKILL.md principal, incorporando boas práticas como manter o corpo enxuto, usar arquivos de referência separados para domínios grandes e adicionar scripts apenas quando as dependências de tempo de execução estiverem confirmadas. A fase de teste recomenda executar de 2 a 3 casos representativos (incluindo casos de borda e negativos) em sessões frescas com e sem a habilidade, inspecionando rastros para detectar passos desnecessários, falsas ativações e aumento de escopo. Por fim, a habilidade exige uma verificação de entrega para garantir que o artefato completo solicitado esteja presente e internamente consistente, que as alterações sejam resumidas e que o status não testado seja honestamente relatado. Isso garante que as habilidades resultantes sejam executáveis, seguras e focadas em tarefas reais.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/rafik-mikhail/write-agent-skill/tree/main

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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

  1. 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ção como uma regra de roteamento concisa que especifica o que ela faz e quando usá-la.
  2. 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.
  3. 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.

Habilidades Relacionadas