15 de mai. de 2026 · risco baixo · primeira versão
write-agent-skill-from-workflow
Skill para transformar uma rotina repetida em instrução copiável com gatilho, ferramentas, risco, proibições e verificação.
antes de delegar
Antes de copiar, confira se a tarefa cabe neste procedimento.
Use esta parte para decidir com calma: caso indicado, risco, limites e verificações. Se a tarefa tocar cliente, produção, pagamento, segredo ou publicação, a confirmação humana vem antes da execução.
Quando usar
Converter workflow real em skill operacional para Hermes, Claude Code, Codex ou agente Markdown genérico.
Não deixe o agente fazer isso
- Inventar uma skill para rotina que ainda não aconteceu de verdade.
- Autorizar produção, cliente, segredo, publicação, pagamento ou exclusão sem regra humana.
- Escrever instrução vaga sem entrada mínima, ferramenta permitida, critério de parada e verificação.
Agentes compatíveis
- Hermes Agent
- Claude Code
- Codex
- agente Markdown genérico
Ferramentas necessárias
- leitura de contexto
- editor de arquivo
- terminal quando autorizado
- navegador quando autorizado
Risco baixo
Pode orientar decisão e escrita. Ainda assim, não autorize acesso novo sem escopo claro.
Regras de parada
- Não peça nem exponha segredos, tokens, senhas ou dados de cliente no prompt.
- Não permita publicação, deploy, merge, exclusão em massa ou mensagem externa sem confirmação humana.
- Quando a ação tocar produção, cliente, pagamento ou credencial, pare e peça decisão humana.
checklist de decisão
Antes de rodar, responda este filtro.
A página guia a escrita de uma instrução copiável; checklist de campos obrigatórios é o visual útil.
- Caso: a tarefa combina com “quando usar” ou está pedindo outra coisa?
- Risco: há produção, cliente, pagamento, segredo, publicação ou exclusão?
- Escopo: quais arquivos, contas, comandos ou mensagens estão liberados?
- Parada: quando o agente deve recusar e devolver a decisão para humano?
- Evidência: qual log, diff, link, teste ou resumo prova que terminou?
instrução copiável
Texto copiável para o agente.
Copie daqui quando o escopo já estiver claro. Se a tarefa tocar produção, cliente, pagamento, segredo ou publicação, pare e peça confirmação humana antes de executar.
Skill: write-agent-skill-from-workflow
Use esta skill quando uma rotina já repetiu o suficiente para virar procedimento copiável para agentes. A skill deve ensinar execução verificável, não virar manifesto.
Agentes compatíveis
- Hermes Agent: use quando a rotina envolve ferramentas, arquivos, cron, memória ou gateway.
- Claude Code: use quando a rotina é desenvolvimento dentro de repo.
- Codex: use quando a rotina é código, teste, diff e PR.
- Agente Markdown genérico: use para transformar processo humano em checklist executável.
Risco
Risco baixo para escrever a skill. Risco médio quando a skill inclui ferramenta. Risco alto se ela autoriza produção, cliente, segredo, publicação, pagamento ou exclusão.
Passos
- Nomeie a rotina: verbo, objeto e contexto.
- Escreva quando usar e quando não usar.
- Liste entradas mínimas.
- Liste ferramentas permitidas.
- Declare risco: baixo, médio ou alto.
- Escreva passos numerados com evidência esperada.
- Adicione seção “Não deixe o agente fazer isso”.
- Adicione verificação final.
- Teste com uma tarefa pequena antes de recomendar uso real.
Não deixe o agente fazer isso
- Criar skill genérica que serviria para qualquer coisa.
- Autorizar ferramenta perigosa sem regra de parada.
- Esconder incerteza ou pré-requisito.
- Colocar segredo, token ou caminho sensível no arquivo.
- Dizer que a rotina está pronta sem teste pequeno.
Saída esperada
Entregue um Markdown com título, descrição, gatilho de uso, agentes compatíveis, risco, ferramentas, passos, proibições e verificação.
Checklist visual
O que executar agora
Use o template de criação de skill para preencher a rotina antes de salvar o arquivo. Se ainda está escolhendo o que pedir para um agente, leia o primeiro mês de agente pessoal ou a série Playbooks de operação com agentes.
Vídeo
Ainda não há vídeo bom para este caso. Não é promessa. A versão útil precisa mostrar uma rotina real virando skill, com limite, ferramenta permitida e verificação.