Exemplos de Claude skills: arquivos SKILL.md reais para você copiar

A maioria dos guias descreve a arquitetura da skill. Este mostra os arquivos de verdade.

O guia para criar skills no Claude Code cobre o básico: o que é um SKILL.md, como funciona um loading map, quando vale a pena construir uma skill. Se você ainda está decidindo se skills fazem sentido no seu workflow, o que são Claude skills é a introdução. Este artigo não repete nada disso. Ele mostra exemplos reais: arquivos de uma biblioteca rodando em produção.

Ninguém publica o próprio SKILL.md. Não os que funcionam de verdade. Você encontra diagramas de arquitetura e explicações abstratas de loading map, mas nada que dê para jogar em .agents/ e testar na segunda-feira. Os exemplos abaixo são de uma biblioteca real: oito skills de persona e dezesseis skills de função rodando um workflow diário. Duas categorias, uma arquitetura, trabalhos diferentes. Esta é a desmontagem.

A biblioteca é uma pasta plana

Cada skill é um subdiretório com um SKILL.md que funciona como roteador e, nas skills de persona, uma pasta references/ dividida por domínio de decisão. A biblioteca que eu uso tem 24 skills dos dois tipos. Skills de persona levam nome de gente: cada uma aponta para uma obra reconhecível e roteia as perguntas para referências destiladas. Skills de função levam o nome do trabalho que fazem: sem calibração de persona, só um checklist e um formato de saída.

Biblioteca de skills: .agents/skills/

• alex-hormozi/persona// design de oferta, preço, garantias
  • SKILL.mdrouter
  • references/// 15 arquivos, um por decisão
• neil-patel/persona// estratégia de SEO
• russell-brunson/persona// funis, escada de valor
• gary-vaynerchuk/persona// conteúdo, atenção
• feynman/persona// clareza didática
• arthur-miller/persona// narrativa, roteiro
• michael-burry/persona// investimento contrarian
• felipe-fontoura/persona// estratégia de negócio
• lifeos-lint/função// health-check da wiki
• lifeos-review/função// revisão semanal
• lifeos-capture/função
• lifeos-ingest/função
• lifeos-journal/função
• lifeos-plan/função
• lifeos-query/função
• lifeos-study/função
• youtube-analyse/função// performance de vídeo
• narration-review/função

Por que nomear uma pessoa funciona melhor que um role prompt genérico, e por que as referências separam a técnica do cosplay, está em skills de persona para o Claude Code. A estrutura acima é onde isso vive no dia a dia.

Anatomia de uma skill de persona: alex-hormozi

Uma skill de persona nomeia uma pessoa, destila o método dela em referências separadas por decisão e roteia cada pergunta para o arquivo dono daquela decisão. A skill alex-hormozi cuida de design de oferta, preço, garantias e retenção. O SKILL.md é só lógica de roteamento. Não contém o método. Tem 15 referências e um loading map que o agente precisa consultar antes de responder.

O bloco de frontmatter é o que o Claude Code lê para decidir se invoca a skill:

---
name: alex-hormozi
description: >
  Designs, critiques, and refines commercial offers — products, pricing,
  guarantees, sales ladders, lead magnets, ads, sales copy, retention plays,
  pricing raises, and fast-cash campaigns. Applies: Value Equation, Grand Slam
  Offer, Core Four advertising, ACA closing, Five Horsemen retention, MAGIC
  naming. Output is a single direct recommendation — not a menu of options.
---

A description nomeia os frameworks explicitamente. “Design de oferta” é vago; “Value Equation, Grand Slam Offer, ACA closing” é uma coordenada. O Claude Code compara a intenção do usuário com essa description para decidir o que invocar. Precisão na description é precisão no gatilho.

O loading map dentro do corpo do SKILL.md é a camada de roteamento:

Loading map de referências do SKILL.md

Referência	Quando carregar
references/00-canon.md	Princípios centrais — carregar em qualquer pergunta
references/01-value-equation.md	Preço, conversão, valor percebido
references/02-grand-slam-offer.md	Construir ou auditar uma oferta nova
references/03-money-models.md	Sequência de produtos, lógica de upsell/downsell
references/04-pricing-and-guarantees.md	Aumento de preço, tipos de garantia, reversão de risco
references/05-naming-and-positioning.md	Naming, fórmula MAGIC, estratégia de nicho
references/06-advertising-and-leads.md	Estratégia de anúncios, hooks, lead magnets
references/07-closing-and-sales.md	Objeções, calls de venda, taxa de fechamento
references/08-retention-and-ltv.md	Diagnóstico de churn, LTV, ponto de ativação
references/09-branding-and-proof.md	Depoimentos, fatores de prova, associação de marca
references/10-fast-cash-plays.md	Injeção trimestral de receita, caixa agora
references/11-decision-checklist.md	Uma oferta específica — ponto de partida recomendado
references/12-canonical-phrases.md	Calibração — carregar quando o tom desvia
references/13-cfa-math-and-scaling.md	Conta de CAC/GP, economia de aquisição paga
references/14-operations-and-scaling.md	Diagnóstico do estágio de escala, rituais de operação

Quinze linhas, quinze decisões. Uma pergunta de retenção carrega retenção, não a biblioteca inteira. Uma pergunta de preço carrega preço. Nada carrega sozinho; o map deixa o roteamento explícito para o modelo não ter espaço para chutar.

A skill alex-hormozi em números

15

arquivos de referênciaum por domínio de decisão

80KB

de método destiladolivros, palestras, playbooks

1

SKILL.md roteador

0

prompts para repetiro estudo mora na skill

Anatomia de uma skill de função: lifeos-lint

Uma skill de função não tem persona. Leva o nome do trabalho que faz, não da pessoa que canaliza. A lifeos-lint roda um health-check numa wiki pessoal: páginas órfãs, links fantasmas, conteúdo desatualizado, camada e tipo que não batem, dívida de colheita. Sem calibração de autor, sem frases canônicas. Só um checklist e um formato de saída rígido. O rigor vem das checagens, não de uma voz.

O frontmatter:

---
name: lifeos-lint
description: >
  Health-check the Life OS wiki. Use when user says "lint", "health check",
  "orphans", "contradictions", or asks about wiki quality. Finds orphan pages,
  weak connections, ghost links, stale content, premature promotions,
  and layer-type mismatches. Suggests improvements; auto-fixes unambiguous issues.
---

Sem seção de identidade, sem frases canônicas, sem calibração de autor. A description lista as frases de gatilho diretamente: lint, health check, orphans, contradictions. A skill é ativada pela linguagem do trabalho, não por um nome.

O corpo do SKILL.md é o checklist:

## Checks (in order)

1. **Orphans** — pages in `20-wiki/` with zero inbound `[[links]]`
2. **Weak pages** — fewer than 3 outbound connections
3. **Ghost links** — `[[links]]` pointing to non-existent pages
4. **Contradictions** — conflicting claims across pages
5. **Stale content** — `updated` date older than 30 days
6. **Layer-type mismatch** — study note in worklog folder, or vice versa
7. **Harvest debt** — work-log drafts older than 14 days, never promoted

O formato de saída é igualmente explícito: um relatório de lint com seções crítica, média e sugestão, um bloco de estatísticas no fim e um append no log.md. O modelo não consegue improvisar o formato. É essa especificidade que torna a skill útil com o tempo. Você bate o olho no mesmo formato de relatório toda semana.

Se você está decidindo se constrói esse tipo de tarefa como skill ou como subagent com MCP, Claude skills versus MCP e subagents cobre a fronteira.

O loading map é todo o truque

O loading map é a parte que a maioria dos SKILL.md por aí simplesmente pula. Sem ele, o modelo decide o que ler. E ele prefere, com toda a consistência, os pesos aos seus arquivos. Vai pelo caminho de menor resistência, que é gerar a partir dos dados de treino em vez de carregar a referência que você levou tempo construindo. O loading map tira essa escolha dele.

O loading map transforma uma sugestão numa regra de roteamento. Escreva a coluna “quando carregar” como uma dor ou uma decisão, não como um rótulo de tema. “Preço, conversão, valor percebido” roteia certo. “Conceitos da value equation” não. Isso descreve um arquivo, não uma pergunta. O agente precisa casar as palavras do usuário com o map; escreva o map na língua que o usuário traz, não na língua do arquivo.

Mais uma disciplina: roteie para o arquivo mais estreito que cobre a decisão. Não carregue 00-canon.md para tudo por padrão. Se o usuário pergunta sobre taxa de fechamento, carregue a referência de fechamento. O canon serve para ancorar, não para toda resposta.

Teste com inputs reais, não com cenários de brinquedo

O teste não é contagem de palavras nem de referências. Uma skill está pronta quando dá conta de uma decisão real: uma oferta que você de fato precificaria, ou uma rodada de verdade na wiki que você de fato checaria. Hipótese não conta.

Antes de colocar uma skill em uso

• ✓Obrigatório:
  A description nomeia frameworks ou frases de gatilho específicas, não só a área do tema."Value Equation, Grand Slam Offer, ACA closing" ganha de "design de oferta".
• ✓Obrigatório:
  As referências são divididas por decisão, não por fonte.pricing-and-guarantees.md ganha de book-1.md.
• ✓Obrigatório:
  Existe um loading map explícito no corpo do SKILL.md.Uma sugestão de consultar as referências não é um loading map.
• ✓Obrigatório:
  Você testou com um input real, algo do seu trabalho de verdade.Um exemplo de brinquedo não é teste.
• ✓Obrigatório:
  A saída é específica: uma recomendação, um veredito de checklist, um relatório de lint.Uma parede de opções não é um modo de saída.
• •Opcional:
  A skill está versionada no git.
• •Opcional:
  Existe pelo menos um exemplo real de um bom input e da saída esperada.

Os cinco primeiros são obrigatórios. Os dois últimos elevam o teto de consistência, mas não bloqueiam. Comece pela decisão que você enfrenta com mais frequência. Essa é a primeira referência. Adicione mais quando um input real revelar um buraco que as referências existentes não cobrem.

A arquitetura é a parte fácil

Um SKILL.md roteador, referências divididas por decisão, um loading map: o guia para criar skills no Claude Code explica tudo isso em umas duas mil palavras. A parte difícil é construir referências de verdade e testar com inputs de verdade.

Os exemplos aqui são de uma biblioteca em produção: uma skill de design de oferta com 15 referências divididas por decisão e uma tabela de roteamento que cobre de preço a retenção, e um auditor de wiki sem persona, com um checklist que pega sete categorias de dívida estrutural. As duas precisaram de vários inputs reais até ficarem certas.

Construa para o trabalho que você repete toda semana. Não para demo.

Qual a diferença entre uma skill de persona e uma skill de função?+

Uma skill de persona nomeia uma pessoa e ativa o método dela: frameworks, critérios de decisão, frases canônicas, tudo destilado em referências divididas por domínio de decisão. Funciona quando existe um corpus público real por trás da pessoa: livros, palestras, playbooks.

Uma skill de função nomeia um trabalho. Sem calibração de autor, sem frases canônicas. O rigor vem do checklist e do formato de saída. Use persona quando o método mora na obra de uma pessoa. Use função quando o método é um checklist técnico.

Por que dividir as referências por decisão e não por fonte?+

Porque a pergunta do usuário chega como uma decisão, não como um capítulo de livro. Uma pergunta sobre churn carrega a referência de retenção. Uma pergunta sobre preço carrega a referência de preço.

Se os seus arquivos se chamam book-1.md e transcript-3.md, o loading map não consegue rotear por decisão. Ele roteia por fonte, o que está errado. A divisão por decisão é o que torna o map utilizável.

O loading map carrega os arquivos automaticamente quando a skill dispara?+

Não. Nada carrega sozinho. O loading map é uma instrução que o modelo precisa seguir: uma tabela que diz ao agente qual arquivo abrir para cada tipo de pergunta.

Sem ele, o modelo decide o que ler. Normalmente não escolhe nada e responde a partir dos dados de treino. O map tira essa escolha dele, deixando o roteamento explícito e obrigatório.

Quantas referências uma skill precisa para ser útil?+

De três a cinco, se cada uma for dona de uma decisão clara. A skill alex-hormozi começou com cinco referências cobrindo construção de oferta, preço e fechamento. As outras dez foram adicionadas com o tempo, conforme inputs reais revelaram buracos.

Comece pela decisão que você enfrenta com mais frequência. Essa é a primeira referência. Adicione mais quando a skill falhar em algo que deveria ter resolvido.

Uma skill de função pode ter loading map?+

Pode. A lifeos-lint não tem loading map porque não tem referências. O método está inteiro no corpo do SKILL.md. Mas uma skill de função mais complexa (um auditor de segurança, um planejador de migração) deveria ter referências divididas por tipo de checagem e um map que roteie de acordo.

O conceito de loading map vale para qualquer skill com vários arquivos de referência, de persona ou não.