Comece por uma linha de base, não por um rascunho
O guia de autoria da Anthropic pede avaliações antes de documentação extensa. Rode o Claude em tarefas representativas sem a skill e anote onde ele falha, monte três cenários sobre essas lacunas, meça a linha de base e escreva só as instruções necessárias para cobri-las. Assim a skill mira falhas que você viu, e não falhas imaginadas, e fica uma linha de base para cada mudança posterior.
Use uma sessão nova e desligue a skill na segunda rodada
A sessão precisa ser nova porque o contexto que sobra de escrever a skill esconde as lacunas do que ficou escrito. No Claude Code, defina uma skill pessoal ou de projeto como "off" em skillOverrides para a segunda rodada; skills de plugin são comparadas com claude plugin eval. O plugin skill-creator automatiza o ciclo: guarda os casos de teste em evals/evals.json, roda cada um no próprio subagente e avalia o resultado.
Teste em cada modelo e observe como o Claude a lê
Uma skill se soma a um modelo, então o guia pede um teste em cada modelo que você pretende usar: se o Haiku recebe orientação suficiente e se o Opus está recebendo mais explicação do que precisa. Depois observe como o Claude percorre a skill. Um arquivo incluído que ele nunca abre pode ser desnecessário ou estar mal sinalizado, e um que ele lê toda vez talvez devesse estar no próprio SKILL.md.