# Worksheet: transformar workflow em skill

## Nome da skill

`verbo-objeto-contexto`

Exemplo: `review-github-pr-with-agent`.

## Quando usar

Escreva o gatilho em linguagem simples:

> Use quando...

## Entrada mínima

- [ ] Qual é o objetivo?
- [ ] Quais arquivos, sistemas ou URLs entram?
- [ ] Quais ferramentas o agente pode usar?
- [ ] Qual risco existe?
- [ ] Como verificar o resultado?

## Passos da skill

| Passo | Ação | Evidência esperada |
|---|---|---|
| 1 | entender contexto | resumo do objetivo e restrições |
| 2 | executar menor unidade segura | diff, arquivo, resposta ou checklist |
| 3 | verificar | teste, build, leitura, link ou revisão humana |
| 4 | reportar | o que mudou, o que não mudou, risco residual |

## Bloco de segurança obrigatório

- Risco: baixo/médio/alto.
- Agentes compatíveis: Hermes, Claude Code, Codex, agente Markdown genérico.
- Não deixar o agente fazer: `...`.
- Parar e pedir humano quando: `...`.

## Teste da skill

Antes de usar de verdade, rode com uma tarefa pequena e sem produção. Se a skill não dá uma saída verificável, ela ainda é só texto bonito.