🟡 Skills, Plugins & Memória

🟡 O que é

Uma Skill é um conjunto reutilizável de instruções que ensina o Claude a executar um fluxo de trabalho específico de forma previsível. É um arquivo SKILL.md com um frontmatter (name + description) que mora em .claude/skills/.

💡 Por que aprender

O segredo das Skills: elas só carregam quando são necessárias. Diferente do CLAUDE.md (sempre na memória), a Skill economiza contexto e aparece só na hora certa — o Claude lê a description e decide invocar.

🔑 CLAUDE.md vs Skill

Regra prática: se o Claude deve sempre saber → CLAUDE.md. Se é para uma tarefa específica → Skill.

🟡 O que é

Você não precisa escrever a Skill do zero: a skill skill-creator entrevista você e gera o SKILL.md. O essencial é a description bem escrita — é ela que faz o Claude saber quando usar.

💡 Por que aprender

Uma Skill bem feita elimina repetição: você escreve o "como fazer" uma vez e ele reusa para sempre. O guia oficial da Anthropic organiza isso em 6 capítulos, do fundamento à distribuição.

🔑 Estrutura mínima de uma Skill

---
name: pr-review
description: Use quando pedir revisão de PR, diff ou código alterado.
---
Ao revisar um PR:
1. Leia o diff completo
2. Aponte riscos de segurança
3. Verifique cobertura de testes
4. Classifique os achados por severidade

🟡 O que é

Plugins empacotam skills, comandos, agentes e hooks num pacote instalável. Você adiciona um marketplace (um repositório GitHub) e instala plugins de lá com /plugin.

💡 Por que aprender

Plugins são o jeito mais rápido de turbinar o Claude Code com trabalho da comunidade. Ex.: Claude Mem dá memória entre sessões; o Vision plugin dá olhos pra ele ler imagens/telas.

🔑 Instalando um plugin

# 1. adicione o marketplace (repo)
/plugin marketplace add thedotmack/claude-mem
# 2. instale o plugin
/plugin install claude-mem

🟡 O que é

Além do CLAUDE.md, o Claude Code tem memória persistente em .claude/projects/<projeto>/memory/, gerenciada pelo /memory. O Memory 2.0 / Auto Dream consolida essas memórias automaticamente.

💡 Por que aprender

Memória entre sessões = você para de reexplicar o projeto toda vez. O agente lembra decisões, correções e convenções de ontem. É o que transforma o Claude num colega que conhece o seu código.

🔑 Como o "dream" funciona

🟡 O que é

O CLAUDE.md tem hierarquia: regras suas (globais), do projeto e locais se combinam. Um bom CLAUDE.md é curto, específico e em tópicos — não um romance. A ideia de "prompt universal" é ter um esqueleto reaproveitável entre projetos.

💡 Por que aprender

CLAUDE.md inchado gasta contexto em toda sessão. O avançado é saber o que não colocar (o que está no código), e o que vale ouro (comandos, convenções, "nunca faça X").

🔑 Hierarquia + esqueleto

# Comandos
- Dev: `pnpm dev` · Test: `pnpm test` · Build: `pnpm build`
# Convenções
- TypeScript estrito, sem `any`
- Componentes em PascalCase
# Regras
- NUNCA commitar na main; sempre branch + PR

🟡 O que é

Skills de design ensinam o Claude a fazer UI bonita de verdade. A frontend-design (Anthropic) já vem no kit; a Impeccable é um fork enriquecido — com 7 referências de domínio sempre carregadas e um detector de "AI slop".

💡 Por que aprender

A diferença entre uma página "de IA genérica" e uma página premium está nessas skills. A Impeccable traz um vocabulário de iteração (23 comandos verbais) para refinar, não só "construa uma página".

🔑 Impeccable em resumo

Quando usar a frontend-design da Anthropic: UI "one-shot" rápida, sem instalar nada extra. Impeccable: quando vai iterar e quer um design system de verdade.