A resposta curta
CLAUDE.md, AGENTS.md e as regras do Cursor ficam no contexto em toda sessão, então limite-os a fatos e limites. Uma Skill só é carregada quando a tarefa dela aparece, o que significa que ela pode conter um procedimento longo sem pesar em todo chat.
Quem lê CLAUDE.md, AGENTS.md e as regras do Cursor
O Claude Code lê o CLAUDE.md, o Codex lê o AGENTS.md e o Cursor lê as próprias regras e também esses dois arquivos. Os três leem o SKILL.md, mas só quando ele é necessário.
| Arquivo | Lido por | Quando |
|---|---|---|
CLAUDE.md | Claude Code, Cursor | Claude Code: no início da sessão, a partir de ~/.claude/CLAUDE.md e do projeto; o arquivo de uma subpasta, quando o Claude passa a trabalhar nela. Cursor: sempre aplicado. |
AGENTS.md | Codex, Cursor | Codex: primeiro ~/.codex/AGENTS.md, depois um arquivo por pasta, da raiz do repositório até onde você começou; o mais próximo vence; 32 KiB no total. Cursor: sempre aplicado. |
.cursor/rules/*.mdc | Cursor | Um de quatro modos: Always Apply, Apply Intelligently, Apply to Specific Files ou Apply Manually |
SKILL.md | Os três | Só quando um pedido combina com ele ou quando você o chama pelo nome |
O que vai no CLAUDE.md e o que vai em uma Skill
Uma boa regra prática: se cabe em uma linha e deve valer em todo chat, é uma instrução. Se leva uma página para explicar e só importa para um tipo de tarefa, é uma Skill.
| Você quer dizer | Coloque em |
|---|---|
| “Use pnpm, não npm.” | Arquivo de instruções |
| “Nunca faça deploy sem aprovação.” | Arquivo de instruções |
| “Rode os testes antes de fazer commit.” | Arquivo de instruções |
| “Como escrevemos uma release note, passo a passo.” | Uma Skill |
| “Monte uma apresentação de lançamento no estilo da nossa marca.” | Uma Skill |
Toda sessão
Arquivos de instruções consomem contexto em todo chat, usados ou não
Quando necessário
Uma Skill custa mais ou menos uma frase até ser usada
Como tirar um procedimento do CLAUDE.md
Um antes e depois comum
Aos poucos, um CLAUDE.md ganha uma seção de 60 linhas sobre como escrever release notes. Todo chat paga por ela, inclusive as sessões de debugging. Mova isso para uma Skill e só uma linha fica para trás, enquanto o procedimento só é carregado quando você pede release notes.
- Use pnpm. Never deploy without approval.
- For release notes, use the release-notes Skill.- 1
Recorte o procedimento para
.claude/skills/release-notes/SKILL.md(ou.agents/skills/para o Codex e o Cursor). - 2
Escreva uma descrição que diga quando usá-la.
- 3
Deixe uma indicação de uma linha no arquivo de instruções.
Você deve ver: um arquivo de instruções mais curto, com o procedimento carregando só quando você pede release notes.
No Cursor, o /migrate-to-skills converte regras “Apply Intelligently” em Skills para você.
Perguntas frequentes
O que é o CLAUDE.md?
Um arquivo Markdown de instruções que o Claude Code lê no início de cada sessão. O seu fica em ~/.claude/CLAUDE.md; o de um projeto fica em CLAUDE.md ou .claude/CLAUDE.md.
Devo usar AGENTS.md ou Skills no Codex?
Use os dois. Coloque regras curtas que sempre valem no AGENTS.md e procedimentos que só devem carregar quando necessário em Skills. O guia do Codex cobre os dois.
As regras do Cursor são a mesma coisa que Skills?
Não. Regras são arquivos .mdc adicionados às conversas; Skills são pastas que o agente usa quando são relevantes ou quando você as chama. Veja o guia do Cursor.
Fontes
Este guia ajudou?
