O teu primeiro skill: /post

O que é um skill?

Até agora, cada pedido ao Claude era descartável: escreves um prompt, obténs um resultado, e da próxima vez escreves tudo de novo. Um skill muda isso. É um comando slash que constróis tu mesmo: escreves /post e o Claude segue as instruções que definiste de uma vez por todas. Os skills persistem entre as conversas: constróis uma vez, reutilizas para sempre.

É o conceito mais importante do curso. A diferença entre um utilizador ocasional e um utilizador 10x não é a qualidade dos seus prompts — é que ele capitaliza. Cada problema resolvido torna-se uma ferramenta permanente. Ao fim de três meses, o utilizador ocasional reescreve as suas instruções; o utilizador 10x tem uma caixa de ferramentas com quinze comandos que codificam toda a sua expertise de negócio.

Para a Lea, o skill /post vai codificar todo o seu processo de publicação: onde procurar a informação, como estruturar um post, que formato de imagem gerar, como registar. Este saber-fazer, hoje na cabeça dela, estará amanhã num ficheiro que o Claude executa a pedido.

Anatomia de um skill

Um skill vive no teu projeto sob a forma de uma pasta que contém um ficheiro SKILL.md:

.claude/
  skills/
    post/
      SKILL.md      <-- as instruções do skill (obrigatório)
      reference.md  <-- (opcional) doc de referência carregada a pedido
      scripts/      <-- (opcional) scripts utilitários do skill

O ficheiro SKILL.md contém um cabeçalho YAML (o «frontmatter»: nome e descrição) seguido das instruções em Markdown livre. O nome da pasta torna-se o comando: .claude/skills/post/ → /post. Eis o aspeto da estrutura:

---
name: post
description: Publica um post numa rede social (texto + visual + registo). Usar quando o utilizador quer publicar ou agendar conteúdo.
---

# Papel
És o gestor de redes sociais da marca...

# Etapas
1. Identificar a plataforma e o tema fornecidos
2. Pesquisar o tema se necessário
3. Redigir o post no formato da plataforma
...

Detalhe que conta: a descrição do frontmatter não é decorativa. É ela que o Claude lê para decidir se o skill é pertinente — pode até invocá-lo por iniciativa própria quando o teu pedido corresponde, sem que escrevas o comando. Uma boa descrição diz o que o skill faz e quando o usar. O corpo do ficheiro, esse, só é carregado em contexto no momento da execução: é isso que permite ter dezenas de skills sem pesar em cada sessão.

Skills de projeto ou skills pessoais?

A regra de decisão é simples: se o skill contém contexto específico do projeto (a voz da Lea, as suas plataformas, as suas API), vai para o projeto. Se codifica um hábito teu, independente do projeto, vai para a tua pasta pessoal.

Construir o skill (começando simples)

Começamos por uma única plataforma para validar todo o pipeline: a geração do texto, do visual e a publicação. Passaremos ao multi-plataforma mais tarde. Esta disciplina — reduzir o âmbito até uma versão mínima funcionar de ponta a ponta — é a competência número um da automatização. Cola este prompt no Claude Code:

cria um novo skill claude code "post" nesta pasta.

papel: gestor de redes sociais IA para linkedin, instagram, twitter, facebook.
o utilizador fornece uma plataforma + qualquer combinação de: um tema, um post a adaptar, um URL (youtube, artigo, pdf), ou as suas próprias imagens.
deduz a intenção a partir do que é fornecido.
mantém um ficheiro de registo dos posts publicados e dos seus URLs.

faz-me perguntas uma de cada vez até teres 95% de certeza de conseguir realizar a tarefa.

A frase mais útil do curso

Repara na última linha: «faz-me perguntas uma de cada vez até 95% de confiança». É um dos padrões mais poderosos com a IA, e merece que nos detenhamos nele.

O reflexo natural é tentar enquadrar tudo no primeiro prompt — e falhar, porque ninguém pensa em tudo de antemão. Este padrão inverte o ónus: é o Claude que te interroga. As suas perguntas revelam os buracos do teu raciocínio («que fazer se o utilizador fornecer uma imagem E um URL?», «o registo deve incluir os rascunhos não publicados?»), que preenches pelo diálogo em vez de antecipares tudo. Responde a uma pergunta de cada vez; quando o Claude tiver contexto suficiente, constrói o skill.

O «uma de cada vez» também é importante: se o Claude fizer oito perguntas de uma só vez, respondes superficialmente às oito. Uma de cada vez, cada resposta alimenta a pergunta seguinte — é uma verdadeira conversa de enquadramento, como com um freelancer competente que recebe o teu briefing.

Testar o skill

Fecha e volta a abrir uma sessão (os novos skills são detetados no arranque). Escreve /: deves ver /post na lista com a sua descrição. Lança um primeiro teste:

/post "dicas de prompts para iniciantes" twitter

O Claude gera um visual, redige o post e publica-o (ou agenda-o), depois regista o resultado. O objetivo aqui não é o volume: é validar o pipeline completo antes de escalar. Se uma chave API estiver errada, uma conta mal ligada ou um formato de imagem recusado pela plataforma, descobres agora, num único post de teste — não ao publicar uma semana de conteúdo.

flowchart LR
  A["/post tema + plataforma"] --> B["Pesquisa do tema"]
  B --> C["Redação do texto"]
  C --> D["Geração do visual"]
  D --> E["Publicação via API"]
  E --> F["Registo dos posts"]

Ligar as API sem arrancar os cabelos

Para publicar realmente, o teu skill precisa de aceder às API das redes sociais — seja chamando diretamente uma API de publicação (a maioria das ferramentas de agendamento de posts propõe uma), seja via um servidor MCP (Model Context Protocol), o standard que permite ligar ferramentas externas ao Claude Code com o comando claude mcp add. Boa notícia: não precisas de ler a documentação tu mesmo. Dá o URL da doc ao Claude e diz-lhe «lê esta doc e configura a integração».

Para as chaves API, a convenção limpa: um ficheiro .env na raiz do projeto (adicionado ao .gitignore!), que os comandos referenciam sem nunca mostrar o valor. Pede explicitamente ao Claude para respeitar esta convenção — e é exatamente o tipo de regra que gravaremos no CLAUDE.md no capítulo 8.