Skills, CLAUDE.md, subagents, hooks o MCP, cuándo usar cada uno
Claude Code tiene cinco capas de personalización. CLAUDE.md, Skills, subagentes, hooks y servidores MCP. Elige la incorrecta y obtendrás una Skill que nunca se activa, un hook que realiza el trabajo de un subagente o un CLAUDE.md tan inflado que consume la mitad de tu contexto antes de que escribas.
Aquí es donde pertenece cada una.
CLAUDE.md
Se carga en cada conversación. Úsalo para reglas que nunca quieres que se omitan, como "modo estricto de TypeScript" o "nunca toques el esquema de la base de datos".
Si una regla solo importa a veces, no pertenece aquí. Pagarás tokens por ella en cada prompt.
La regla general publicada por Anthropic es mantener CLAUDE.md por debajo de 200 líneas. Por cada línea, pregunta si eliminarla realmente haría que Claude cometiera errores. Si no es así, elimínala. Un CLAUDE.md inflado no hace que Claude obedezca más reglas, sino que hace que Claude ignore la mitad de ellas porque las importantes se pierden en el ruido.
Si supera las 200 líneas, la guía oficial es mover el contenido de referencia a Skills o dividirlo en archivos de .claude/rules/ que solo se cargan cuando Claude trabaja en rutas coincidentes.
Skills
Archivos Markdown que Claude carga automáticamente cuando una solicitud coincide con la descripción en su frontmatter. El lugar adecuado para listas de verificación de revisión de PR, procedimientos de lanzamiento, convenciones específicas de bibliotecas, cualquier cosa específica de la tarea.
La descripción debe cubrir dos cosas, qué hace la skill y cuándo usarla. Omite el cuándo y Claude nunca cargará la skill, sin importar cuán bueno sea el cuerpo. Pon el caso de uso clave primero, ya que la descripción tiene un límite de 1.536 caracteres en la lista de skills.
El cuerpo tiene su propio límite. Anthropic recomienda mantener SKILL.md por debajo de 500 líneas y mover el material de referencia largo a archivos separados a los que la skill enlaza. Una vez que una skill se carga, su contenido permanece en el contexto durante el resto de la sesión, por lo que cada línea es un costo recurrente de tokens.
Subagents
Se ejecutan en su propia ventana de contexto. Le entregas una tarea, trabaja de forma independiente con su propio presupuesto de tokens y obtienes el resultado.
Lo mejor para investigación paralela, aislar trabajo ruidoso o tareas que necesitan herramientas que no quieres en tu sesión principal. Coordinar varios a la vez requiere cierto cuidado, ya que no comparten estado.
Los subagentes también pueden usar Skills, pero tienes que habilitarlas explícitamente con el campo de frontmatter skills. A diferencia de la sesión principal, las descripciones de las skills no se cargan automáticamente en el subagente, por lo que el desencadenamiento por coincidencia de descripción no ocurre por sí solo.
Hooks
Las instrucciones de CLAUDE.md son consultivas, Claude decide si seguirlas. Los hooks son deterministas. El evento se dispara, el hook se ejecuta, sin juicios. Son los únicos de los cinco que omiten el modelo por completo.
Los eventos a los que la mayoría de la gente se engancha son PreToolUse (validar o bloquear una llamada a herramienta antes de que se ejecute), PostToolUse (reaccionar después de una llamada a herramienta, como linting de archivos que Claude acaba de editar), UserPromptSubmit (interceptar lo que se envía a Claude) y SessionStart (cargar contexto una vez por sesión).
Por eso los hooks son el lugar adecuado para las barreras de seguridad. "Nunca edites .env" en CLAUDE.md o una Skill es una solicitud. Un hook PreToolUse que bloquea la edición es una aplicación.
Si tu regla es "ejecuta X cada vez que Claude haga Y", eso es un hook. Linters, formateadores, validadores, registro de auditoría.
MCP servers
Los otros cuatro dan forma a cómo piensa Claude. MCP le da a Claude cosas nuevas que hacer, como hablar con APIs, bases de datos o sistemas internos. A veces una CLI es suficiente, a veces realmente necesitas un servidor MCP.
Cómo se combinan
- CLAUDE.md para reglas estrictas
- Skills para procedimientos y conocimiento del dominio
- Subagents para trabajo delegado
- Hooks para efectos secundarios automáticos
- MCP servers para el mundo exterior
La trampa es volcar todo en Skills. Una restricción que siempre se aplica todavía pertenece a CLAUDE.md. Un efecto secundario al guardar un archivo todavía pertenece a un hook.
Para la versión larga, el curso gratuito de Anthropic Introducción a las Skills de Agente en Skilljar recorre todo el rubric, y el video de tres minutos lo cubre en el tiempo que se tarda en preparar café.