La respuesta corta
CLAUDE.md, AGENTS.md y las reglas de Cursor están en el contexto en cada sesión, así que limítalos a datos y límites. Una Skill se carga solo cuando aparece su tarea, lo que significa que puede contener un procedimiento largo sin cargar cada chat.
Quién lee CLAUDE.md, AGENTS.md y las reglas de Cursor
Claude Code lee CLAUDE.md, Codex lee AGENTS.md y Cursor lee sus propias reglas más esos dos archivos. Los tres leen SKILL.md, pero solo cuando hace falta.
| Archivo | Lo lee | Cuándo |
|---|---|---|
CLAUDE.md | Claude Code, Cursor | Claude Code: al empezar la sesión, desde ~/.claude/CLAUDE.md y el proyecto; el archivo de una subcarpeta, cuando Claude trabaja en esa carpeta. Cursor: siempre se aplica. |
AGENTS.md | Codex, Cursor | Codex: primero ~/.codex/AGENTS.md y luego un archivo por carpeta, desde la raíz del repositorio hasta donde empezaste; gana el más cercano; 32 KiB en total. Cursor: siempre se aplica. |
.cursor/rules/*.mdc | Cursor | Uno de cuatro modos: Always Apply, Apply Intelligently, Apply to Specific Files o Apply Manually |
SKILL.md | Los tres | Solo cuando una petición encaja con ella o la llamas por su nombre |
Qué va en CLAUDE.md y qué va en una Skill
Una buena regla general: si cabe en una línea y debe cumplirse en cada chat, es una instrucción. Si hace falta una página para explicarlo y solo importa para un tipo de tarea, es una Skill.
| Quieres decir | Ponlo en |
|---|---|
| “Usa pnpm, no npm.” | Archivo de instrucciones |
| “Nunca despliegues sin aprobación.” | Archivo de instrucciones |
| “Ejecuta los tests antes de hacer commit.” | Archivo de instrucciones |
| “Cómo escribimos una nota de versión, paso a paso.” | Una Skill |
| “Crea una presentación de lanzamiento con el estilo de nuestra marca.” | Una Skill |
En cada sesión
Los archivos de instrucciones consumen contexto en cada chat, los uses o no
Cuando hace falta
Una Skill ocupa más o menos una frase hasta que se usa
Cómo sacar un procedimiento de CLAUDE.md
Un antes y después habitual
Un CLAUDE.md va acumulando poco a poco una sección de 60 líneas sobre cómo escribir notas de versión. Cada chat paga por ella, incluidas las sesiones de depuración. Pásala a una Skill y solo queda una línea, mientras que el procedimiento se carga únicamente cuando pides notas de versión.
- Use pnpm. Never deploy without approval.
- For release notes, use the release-notes Skill.- 1
Mueve el procedimiento a
.claude/skills/release-notes/SKILL.md(o a.agents/skills/para Codex y Cursor). - 2
Escribe una descripción que diga cuándo usarla.
- 3
Deja una referencia de una línea en el archivo de instrucciones.
Deberías ver: un archivo de instrucciones más corto, con el procedimiento cargándose solo cuando pides notas de versión.
En Cursor, /migrate-to-skills convierte por ti las reglas “Apply Intelligently” en Skills.
Preguntas frecuentes
¿Qué es CLAUDE.md?
Un archivo Markdown de instrucciones que Claude Code lee al principio de cada sesión. El tuyo está en ~/.claude/CLAUDE.md; el de un proyecto, en CLAUDE.md o .claude/CLAUDE.md.
¿Debo usar AGENTS.md o Skills en Codex?
Usa los dos. Pon en AGENTS.md las reglas breves que siempre se cumplen, y en Skills los procedimientos que solo deben cargarse cuando hacen falta. La guía de Codex cubre ambos.
¿Las reglas de Cursor son lo mismo que las Skills?
No. Las reglas son archivos .mdc que se añaden a las conversaciones; las Skills son carpetas que el agente usa cuando son relevantes o cuando las llamas. Consulta la guía de Cursor.
Fuentes
¿Te ha sido útil esta guía?
