CLAUDE.md o skill: ¿Claude lo necesita siempre?
¿CLAUDE.md o skill? Pregúntate si Claude lo necesita siempre: el CLAUDE.md se lee en cada conversación y un skill, solo cuando la tarea lo pide.
Cada vez que algo te sale mal con Claude, la tentación es añadir una línea al CLAUDE.md. Con los meses, ese archivo acaba lleno de instrucciones que solo hacen falta de vez en cuando. La pregunta que lo ordena es una sola: ¿CLAUDE.md o skill? ¿Claude lo necesita siempre?
Es el día 25 de #30DaysOfClaude; el resto de tips está en el índice de la serie.
CLAUDE.md o skill: lo que cambia es cuándo se lee
Según la guía de buenas prácticas de Claude Code, el CLAUDE.md se carga en cada sesión, así que solo debería llevar lo que aplica a todo. Para lo que hace falta solo a veces están los skills: de cada uno, Claude ve el nombre y la descripción, y el contenido solo se carga cuando la tarea lo pide.
Si quieres la comparación completa entre los dos, la tienes en Skills vs. CLAUDE.md en Claude Code. Este tip va de la decisión del día a día: dónde pongo esta línea.
Siempre o solo a veces: ejemplos de CLAUDE.md y de skill
- Siempre, al CLAUDE.md: cómo quieres que escriba (el tono, el largo de las frases) y de qué va tu empresa y para quién trabajas. Son hechos que valen para cualquier encargo.
- Solo a veces, a un skill: cómo se hace una tarea concreta, por ejemplo cómo preparas una propuesta a un cliente o cómo escribes y clasificas tus correos. Son procedimientos: pasos, estructura y criterios que solo hacen falta cuando toca esa tarea.
La documentación lo resume igual: crea un skill cuando una sección del CLAUDE.md se ha convertido en un procedimiento en vez de un hecho.
Por qué no vale meterlo todo "por si acaso"
Porque lo que está en el CLAUDE.md lo lee también cuando solo le pides un correo rápido. La guía avisa de que un CLAUDE.md demasiado largo hace que Claude pase por alto tus instrucciones de verdad: si una regla se salta una y otra vez, probablemente se está perdiendo entre el resto.
Revisa mi CLAUDE.md. Deja lo que necesitas en cada conversación y pasa a skills lo que solo hace falta para tareas concretas. Antes de cambiar nada, enséñame qué moverías.
Tu paso para hoy: abre tu CLAUDE.md y pregúntale a cada línea si Claude se equivocaría sin ella. Si no, bórrala. Si solo la necesita para una tarea, muévela a un skill.
Cuándo no sacarlo del CLAUDE.md
- Si es corto y lo usas casi siempre. Un skill para dos líneas que aplican a todo solo añade un paso.
- Si es algo que se repite en cada tarea, como tu tono o de qué va tu empresa. Eso es justo lo que el CLAUDE.md hace bien.
Y si lo que te pasa es que le explicas lo mismo cada semana, el tip del día 17 va de eso: si se lo explicas cada semana, ya es un skill.
¿Cuántas líneas de tu CLAUDE.md necesita Claude de verdad en cada conversación?
Preguntas frecuentes
¿Por qué Claude ignora instrucciones de mi CLAUDE.md?
Muchas veces, porque el archivo es demasiado largo. Claude lo lee entero al empezar cada conversación, y cuantas más líneas tiene, más se diluye cada una. La guía de Claude Code recomienda dejar ahí solo lo que aplica siempre y pasar a skills lo que hace falta a veces.
¿Cómo sé si una línea de mi CLAUDE.md sobra?
Pregúntate si Claude se equivocaría sin ella. Si no, bórrala. Y si la necesita solo para una tarea concreta, guárdala en un skill.
¿Cómo paso una parte de mi CLAUDE.md a un skill?
Pídeselo a Claude en Claude Code: que revise tu CLAUDE.md, te enseñe qué movería a un skill y, cuando le des el OK, cree los skills con ello.