📘 Skill Spec Template

Template de Skill Spec

Modelo canônico para documentar qualquer skill de forma genérica, portável e separada do workflow interno do sistema.

1. Objetivo da Skill

Explique o que a skill faz, para quem serve e qual problema resolve. Não descreva a orquestração específica do seu sistema aqui.

2. Contrato de Entrada e Saída

Entradas

tema, link, briefing, arquivos, opções

Saídas

artefatos, JSONs, mensagens, arquivos e efeitos colaterais permitidos

3. Fluxo Canônico

Ingestão: como a skill começa.
Pesquisa opcional: quando o fluxo depende de dados atuais.
Processamento principal: onde a capability central acontece.
Produção/entrega: como o resultado final é gerado e distribuído.

4. Pontos de Adaptação

agente único ou multi-agente
modelos usados por etapa
canais de entrega
render, storage e integrações

5. Regras Permanentes

documente o que nunca pode ser quebrado
separe contrato genérico da implementação real
deixe explícitos riscos e limites importantes

6. Relação com Workflow

A Skill Spec descreve o contrato genérico. O Workflow descreve a implementação real dentro do sistema.

Skill Spec = portável, genérica, instalável
Workflow = específico, operacional, real