Skills vs. CLAUDE.md en Claude Code: cuándo usar cada uno

El concepto que cambia todo en Claude Code

Si usas Claude Code, probablemente ya escribes instrucciones en algún archivo para que Claude "recuerde" cómo trabajar contigo. Pero hay dos formas de hacerlo, y elegir la correcta marca la diferencia entre un asistente que te entiende y uno que desperdicia tu tiempo.

Esas dos formas son CLAUDE.md y Skills. Suenan parecidos, pero funcionan de manera muy diferente. En este artículo te explico cuándo usar cada uno, sin tecnicismos.

CLAUDE.md: el contexto que siempre está presente

CLAUDE.md es un archivo de texto que Claude lee al inicio de cada conversación. Piénsalo como el documento de onboarding que le darías a un nuevo empleado: quién eres, cómo trabajas, qué herramientas usas, qué reglas seguir.

Todo lo que pongas en CLAUDE.md, Claude lo tendrá en cuenta siempre. No necesitas pedírselo.

Ejemplos de lo que va en CLAUDE.md:

• "Usa siempre español con acentos correctos"
• "Los archivos del proyecto están organizados en carpetas por cliente"
• "Cuando generes reportes, usa formato PDF"
• "Mi empresa se llama Acme Corp y nuestro sector es fintech"

La trampa del CLAUDE.md demasiado largo

Cada línea de tu CLAUDE.md consume espacio en la memoria de Claude. Si metes 500 líneas con instrucciones para cada posible escenario, Claude empieza a ignorar partes. La comunidad recomienda mantenerlo por debajo de 200 líneas.

La clave: escribe solo las reglas que Claude necesita en todas las sesiones. El resto va en Skills.

Skills: instrucciones que se activan cuando las necesitas

Los Skills son como herramientas especializadas que Claude solo carga cuando son relevantes. En vez de tener todo en un archivo gigante, separas las instrucciones por tarea.

Un Skill es una carpeta con un archivo SKILL.md que describe qué hacer. Puedes invocarlo escribiendo /nombre-del-skill o Claude puede activarlo automáticamente si detecta que es relevante para lo que le pides.

Ejemplos de Skills:

• /deploy para publicar tu proyecto en producción
• /generar-reporte para crear un informe con formato específico
• /analizar-facturas para extraer datos de documentos

Por qué los Skills son más eficientes

A diferencia de CLAUDE.md, los Skills no consumen memoria en cada conversación. Solo se cargan cuando los necesitas. Esto significa que puedes tener 50 Skills diferentes sin que afecten el rendimiento de Claude en tareas donde no son relevantes.

Además, los Skills pueden:

• Recibir parámetros: /analizar-facturas enero-2026
• Incluir archivos de apoyo: plantillas, ejemplos, scripts
• Ejecutarse en aislamiento: sin interferir con tu conversación principal

La comparación que importa

Ejemplo práctico: un consultor independiente

Imagina que eres consultor y trabajas con 5 clientes diferentes. Así organizarías tu configuración:

En CLAUDE.md (aplica siempre):

• Tu nombre, empresa y rol
• Que siempre uses español formal
• Que los documentos lleven tu logo
• Tus tarifas y horarios

Como Skills (solo cuando los necesitas):

• /propuesta para generar una propuesta comercial con tu plantilla
• /factura para crear una factura con los datos del cliente
• /resumen-semanal para compilar un informe de actividades
• /seguimiento para redactar un email de seguimiento post-reunión

Si metieras todo en CLAUDE.md, tendrías un archivo de 400 líneas que Claude leería en cada conversación, incluso cuando solo quieres que te ayude con un email rápido.

Errores comunes que evitar

1. Meter instrucciones de tareas en CLAUDE.md. Si tienes un flujo de deploy con 15 pasos, eso es un Skill, no una regla permanente.

2. Pensar que CLAUDE.md es obligatorio para Claude. Es una guía, no una ley. Claude lo sigue aproximadamente el 80% del tiempo. Para reglas que deben cumplirse siempre (como "nunca borrar archivos sin confirmar"), usa los hooks de configuración.

3. No usar ninguno de los dos. Repetir las mismas instrucciones en cada conversación es la forma más ineficiente de usar Claude Code. Invierte 15 minutos en configurar tu CLAUDE.md y tus primeros Skills.

4. Olvidar la memoria automática. Claude también escribe sus propias notas (en un archivo llamado MEMORY.md) basándose en tus correcciones. Si le dices "no hagas eso", Claude lo recordará para la próxima vez. No necesitas añadirlo manualmente a CLAUDE.md.

Por dónde empezar

Si todavía no tienes configurado nada:

1. Crea un CLAUDE.md con 10-20 líneas: tu nombre, tu proyecto, tus preferencias básicas
2. Identifica 2-3 tareas repetitivas que haces con Claude (reportes, emails, análisis)
3. Convierte cada una en un Skill con su propio SKILL.md
4. Itera: cada vez que le repitas algo a Claude, pregúntate si debería estar en CLAUDE.md o en un Skill

En nuestros workshops de Claude Code dedicamos un bloque completo a configurar CLAUDE.md y crear Skills personalizados. Es uno de los ejercicios que más impacto tiene, porque cada participante sale con un sistema diseñado para su trabajo específico.