Agent Skill
O método que o seu Assistant segue para construir na Sublime, as seis fases que ele não pode pular, e as leis que ele obedece enquanto trabalha.
Você não constrói na Sublime clicando em telas. Você descreve o processo do seu negócio para o seu Assistant, e ele constrói, mede e submete à publicação enquanto você decide o que precisa ser decidido.
A Agent Skill é o método que ele segue para fazer isso. Ela não é um conjunto de instruções sobre a plataforma: é um processo com fases, portões e leis, e o Assistant não pode pular nenhuma delas. Sem ela, um Assistant com acesso à plataforma escreveria procedimentos plausíveis; com ela, ele descobre como o trabalho acontece antes de codificá-lo.
As seis fases
DISCOVER → REDESIGN → MODEL → BUILD → CALIBRATE → PROVE
| Fase | O que acontece |
|---|---|
| Discover | levanta como o trabalho acontece de verdade, a partir de casos concretos |
| Redesign | define como o processo deveria funcionar, e você decide |
| Model | vira conhecimento, procedimentos e tabelas de decisão |
| Build | constrói os artefatos em preview e compila a régua antes de medir |
| Calibrate | mede, muda uma coisa por rodada, mede de novo |
| Prove | reúne a evidência, passa pelo portão e publica |
A ordem é obrigatória e cada fase consome a anterior, o que impede o atalho mais caro que existe em automação: implementar o processo que foi descrito sem antes verificar se é o processo certo.
Cada fase também tem uma condição de saída declarada, então ele não avança porque a conversa esfriou. Discover só fecha quando há casos concretos suficientes e a lista de falhas parou de crescer, e Calibrate só fecha quando o portão de qualidade aprova ou o limite de calibração que você declarou se esgota.
As sete leis
| Lei | O que ela impede |
|---|---|
| Julgue o processo antes da implementação | automatizar um processo ruim |
| Escreva a régua antes do comportamento | aprovar o agente por aquilo que ele conseguiu fazer |
| Decisão declarada não deve ser inferida | pedir julgamento ao modelo onde já existe regra |
| Uma mudança por medição | um resultado que não se sabe a quem atribuir |
| Diferença dentro da dispersão não é ganho | comemorar ruído |
| O contrato não pode ser ajustado para o teste passar | mover a régua até o agente alcançá-la |
| O estado da plataforma é a verdade | acreditar no relato em vez de conferir |
Três delas mudam o que você vai sentir na prática.
Julgue o processo antes da implementação. Quando há uma mudança substancial a propor, ele apresenta a questão e a consequência e espera a sua decisão, porque mudar o processo é uma decisão de negócio e não uma escolha de engenharia. Automatizar um processo ruim apenas torna os erros dele sistemáticos e rápidos.
O contrato não pode ser ajustado para o teste passar. Um agente que não alcança a régua é um agente a calibrar, e não uma régua a afrouxar. Sem essa lei, toda medição converge para a aprovação, porque afrouxar é sempre o caminho mais curto.
O estado da plataforma é a verdade. Depois de escrever, ele relê o que ficou gravado antes de afirmar que a operação passou. Ele não conclui a partir do que pretendia fazer.
Instalar
Um comando, que encontra os agentes instalados na máquina e pergunta em quais escrever:
npx @sublime.am/skill
Funciona em Claude Code, Cursor, Codex, Copilot, Gemini CLI, Windsurf, OpenCode e outros. Reinicie o agente depois, porque Skills são carregadas na inicialização.
Para o time inteiro, --project escreve a Skill dentro do repositório, versionada junto com o código a que ela serve, e quem clonar recebe a Skill sem instalar nada. Um aviso vale nesse caminho: no Claude Code, uma Skill instalada no seu usuário vence a do projeto, então quem já tinha a versão pessoal continua rodando ela mesmo depois de clonar. --uninstall remove a pessoal e alinha o time na mesma versão.
No Claude Code há ainda o caminho do marketplace, que é o recomendado para quem está começando, porque instala a Skill e conecta o servidor MCP no mesmo ato.