La respuesta corta
¿Qué va en CLAUDE.md y qué va en una Skill?
CLAUDE.md guarda las reglas permanentes del proyecto; una Skill documenta un proceso reusable; los archivos de contexto contienen el detalle que solo se consulta cuando hace falta.
Si solo leés una cosa
Las 4 ideas clave
- Mantené CLAUDE.md específico y, como referencia, debajo de 200 líneas.
- Mové los procedimientos repetibles a Skills que se cargan cuando se necesitan.
- La descripción de una Skill debe explicar qué hace y cuándo usarla.
- Revisá cualquier Skill descargada: puede contener instrucciones, recursos y código.
Mapa visual
Contexto por capas
Lo permanente entra siempre; el procedimiento y el detalle se cargan cuando la tarea lo necesita.
CLAUDE.md, Skills y archivos de contexto no son lo mismo
CLAUDE.md contiene instrucciones persistentes para un proyecto: cómo está organizado, cuáles son las reglas y cómo se verifica un resultado. Claude Code lo carga al inicio de cada sesión según su ubicación.
Una Skill es un procedimiento reusable que incluye un archivo SKILL.md y, si hace falta, ejemplos, plantillas o scripts. Su contenido completo se carga cuando la tarea lo activa, no en cada conversación.
Los archivos de contexto guardan información extensa o cambiante: productos, audiencias, mensajes, research y operaciones. El archivo principal debería apuntar hacia ellos en lugar de copiarlos completos.
En corto:
CLAUDE.md: las reglas del espacio de trabajo.SKILL.md: cómo ejecutar una tarea repetible.context/*.md: los datos específicos que la tarea puede consultar.
La estructura mínima de contexto
Empezá con una carpeta sencilla. No necesitás construir un sistema operativo el primer día.
CLAUDE.md— identidad, prioridades, reglas y mapa de archivos.
context/brand.md— voz, mensajes y palabras que evitamos.
context/offers.md— ofertas, precios, audiencia y promesas vigentes.
context/audience.md— preguntas, objeciones y lenguaje real.
.claude/skills/— una carpeta por proceso reusable.
La idea no es llenar carpetas. Es que exista una fuente clara para cada tipo de información.
Qué debería decir tu CLAUDE.md
El archivo debería ser específico, estructurado y corto. La documentación de Claude Code recomienda apuntar a menos de 200 líneas porque estos archivos consumen contexto desde el inicio y las instrucciones pierden fuerza cuando compiten con demasiado texto.
Usá esta plantilla:
# Quién soy y qué construyoSoy [rol]. Este proyecto es [negocio/proyecto] para [audiencia]. La prioridad actual es [objetivo].
# Cómo trabajar conmigo- Escribí en español latinoamericano claro.
- No inventés datos, testimonios ni fuentes.
- Antes de una acción externa, pedí aprobación.
- Explicá supuestos y verificá el resultado.
# Mapa de contexto- Marca y tono:
context/brand.md- Ofertas vigentes:
context/offers.md- Audiencia y research:
context/audience.md
# Definición de terminadoEl trabajo está terminado cuando [pruebas concretas].
No pongás aquí todo tu negocio, transcripciones completas, passwords ni instrucciones de una campaña temporal. Si una regla solo aplica a una tarea, pertenece en una Skill.
Cómo crear una Skill útil
Una Skill convierte un proceso que ya entendés en un manual que la IA puede seguir. Cada Skill vive en su propia carpeta y requiere un SKILL.md con frontmatter YAML y las instrucciones.
Estructura básica:
.claude/skills/revisar-campana/
├── SKILL.md
├── template.md
└── examples/ejemplo-aprobado.md
Plantilla inicial para SKILL.md:
---
name: revisar-campana
description: Revisa una campaña antes de publicar. Usar cuando se solicite QA de copy, enlaces, tracking, audiencias o piezas.
---
# ObjetivoDetectar errores y entregar una lista priorizada antes del lanzamiento.
# InputsBrief aprobado, enlaces, piezas, UTMs y fecha de publicación.
# Proceso1. Confirmar que están todos los inputs.
2. Comparar piezas contra el brief.
3. Probar enlaces y convenciones UTM.
4. Separar bloqueantes, mejoras y preguntas.
# LímitesNo publicar ni modificar campañas. No usar datos personales en ejemplos.
# Formato de salidaResumen, bloqueantes, mejoras, preguntas y recomendación final.
La descripción importa: es lo que ayuda a Claude o ChatGPT a decidir cuándo usar la Skill. Escribí qué hace y en qué situaciones debe activarse.
Skills de Claude y ChatGPT: qué se comparte
Claude Code y ChatGPT soportan Skills reutilizables, y ambos se apoyan en el estándar abierto Agent Skills. El corazón portable es una carpeta con SKILL.md, instrucciones y recursos de apoyo.
No significa que cada función sea idéntica en todas las superficies. Los permisos, herramientas disponibles, rutas de instalación y extensiones de cada producto pueden variar. Diseñá el procedimiento de forma portable y documentá aparte cualquier detalle específico de Claude, ChatGPT, Codex o tu empresa.
Antes de instalar una Skill de internet, leé todo el contenido y revisá scripts y permisos. Una Skill puede contener código e instrucciones; “gratis” no significa automáticamente seguro.
Cinco Skills gratis para empezar
Podés copiar la estructura anterior y adaptarla a estos procesos:
- Revisar campaña: brief, links, UTMs, ortografía y aprobaciones.
- Resumen semanal: decisiones, riesgos, responsables y fechas desde notas autorizadas.
- Entrevista a insights: temas, citas, objeciones y oportunidades sin inventar evidencia.
- Deck ejecutivo: outline, fuentes, una conclusión por slide y verificación de datos.
- Publicar repositorio: privacidad, README, demo, pruebas y checklist antes de hacer público.
Cada una debería incluir un ejemplo aprobado y al menos un caso difícil. Eso enseña mejor el estándar que diez adjetivos como “excelente” o “profesional”.
El ejercicio que organiza tu negocio sin sobrecargar el contexto
Pedile a Claude que te entreviste, pero no le digás que meta todas las respuestas en CLAUDE.md.
Entrevistame para entender mi negocio y construir un sistema de contexto. Preguntá por audiencia, ofertas, voz, procesos, herramientas, restricciones y definición de calidad. Al terminar, proponé: 1) un
CLAUDE.mdde menos de 200 líneas con solo instrucciones permanentes; 2) archivos separados para información detallada; 3) las tres primeras Skills que vale la pena documentar. No escribas archivos hasta que yo apruebe la arquitectura.
Respondé con detalle una vez. Luego revisá qué cambia frecuentemente y qué permanece. El objetivo no es crear una enciclopedia para la IA: es que encuentre la información correcta en el momento correcto.
Cómo saber si el sistema funciona
No midás cuántos archivos creaste. Medí si reduce aclaraciones y mejora resultados.
- ¿Otra persona puede usar la Skill sin preguntarte cómo?
- ¿La IA encuentra la fuente correcta sin cargar todo?
- ¿El resultado pasa el checklist con menos correcciones?
- ¿Hay una dueña y una fecha de revisión?
- ¿Podés eliminar una instrucción obsoleta sin miedo?
Empezá con un CLAUDE.md, tres archivos de contexto y una Skill. Usalos durante dos semanas. El contexto útil se diseña con uso real, no acumulando documentos.
Sin tecnicismos
Preguntas frecuentes
¿CLAUDE.md es un system prompt?
No es una barrera técnica ni una política forzada. Es contexto persistente que guía a Claude Code y puede convivir con permisos y hooks más estrictos.
¿Cuánto debería medir CLAUDE.md?
La documentación recomienda apuntar a menos de 200 líneas. Más importante que el número es que cada instrucción sea permanente, concreta y no compita con otra.
¿Una Skill de Claude funciona en ChatGPT?
El núcleo sigue el estándar abierto Agent Skills, pero cada producto puede tener rutas, permisos y extensiones diferentes. Revisá la compatibilidad de la superficie donde la instalarás.
¿Qué Skill debería crear primero?
La tarea que repetís, ya sabés evaluar y otra persona necesita ejecutar: por ejemplo QA de campañas, resumen semanal o deck ejecutivo.
¿Es seguro descargar Skills gratis?
Solo después de leer sus instrucciones, revisar archivos y scripts, entender permisos y confiar en la fuente. Un escaneo automático no sustituye tu revisión.
Para verificar y seguir