CLAUDE.md, contexto y Skills: qué guardar dónde para no construir una bodega

Si cada conversación empieza con veinte minutos explicando quién sos, qué vendés y cómo trabajás, no te falta un prompt más largo. Te falta organizar el contexto.

La solución práctica tiene dos capas: un archivo CLAUDE.md corto que funciona como manual de entrada y Skills separadas para los procesos que solo hacen falta a veces. Una Skill (un paquete reusable de instrucciones y recursos para completar una tarea) le enseña a la IA cómo ejecutar un proceso concreto. Así recibe lo esencial siempre y carga el detalle cuando el trabajo lo requiere.

Qué función cumplen CLAUDE.md, Skills y archivos de contexto

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 (el agente de Anthropic que trabaja con código y archivos) 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, investigación 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.

Mantené 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é construyo Soy [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 terminado El 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. --- # Objetivo Detectar errores y entregar una lista priorizada antes del lanzamiento. # Inputs Brief aprobado, enlaces, piezas, UTMs y fecha de publicación. # Proceso 1. 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ímites No publicar ni modificar campañas. No usar datos personales en ejemplos. # Formato de salida Resumen, 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. Si querés mover un proceso entre plataformas, usá la guía de ChatGPT Work y Codex: cómo migrar workflows para separar las instrucciones portables de las conexiones específicas.

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.

Skill, plugin, app y MCP: cuatro cosas distintas

Estos nombres suelen aparecer juntos, pero resuelven problemas diferentes:

MCP significa Model Context Protocol (un estándar para conectar una IA con herramientas y fuentes externas). Instalar una Skill no concede acceso automático a Drive, Slack o una base de datos. Esa autorización ocurre en la app, el conector o el servidor MCP correspondiente y conserva sus propios permisos.

Un ejemplo completo ayuda a verlo:

1. La Skill dice cómo preparar el resumen semanal.
2. Un conector permite leer una carpeta específica de Drive.
3. Las instrucciones exigen citar cada fuente y marcar datos faltantes.
4. La salida se guarda como borrador.
5. Una persona aprueba antes de compartirlo.

La Skill aporta el método. La conexión aporta acceso. La persona conserva la decisión sensible.

Los building blocks de una Skill completa

Una Skill útil necesita más que una lista de pasos. Incluí estos bloques:

1. Cuándo usarla: la situación que debe activarla.
2. Resultado esperado: qué archivo, decisión o entrega debe producir.
3. Inputs: qué información necesita y cuál es su fuente oficial.
4. Proceso: pasos en el orden correcto.
5. Criterios de calidad: cómo distinguir un buen resultado de uno incompleto.
6. Límites: qué no debe hacer y cuándo debe pedir ayuda.
7. Ejemplos: al menos uno correcto y uno difícil.
8. Verificación: qué revisar antes de considerar la tarea terminada.

Si falta el resultado esperado, la IA puede completar muchos pasos sin resolver el trabajo. Si faltan límites, puede actuar más allá de lo necesario. Si falta verificación, un borrador convincente puede pasar por terminado.

Cómo llevar una Skill de uso personal a un equipo

No compartás una Skill con toda la empresa apenas funcione una vez. Probala primero con la persona que conoce el proceso y después con alguien que no participó en su creación.

Usá esta secuencia:

1. Borrador: una persona documenta el proceso.
2. Prueba: la Skill se ejecuta con tres casos normales y dos casos difíciles.
3. Revisión: la dueña del proceso corrige instrucciones y ejemplos.
4. Piloto: un grupo pequeño la usa durante dos semanas.
5. Publicación interna: se comparte con responsable, versión y fecha de revisión.

Para procesos conectados a correo, archivos o sistemas de clientes, sumá la guía de seguridad y estándares para agentes de IA. Una Skill puede mejorar consistencia, pero no sustituye permisos mínimos, registro de acciones ni aprobación humana.

Cinco Skills gratis para empezar

Podés copiar la estructura anterior y adaptarla a estos procesos:

1. Revisar campaña: brief, links, UTMs, ortografía y aprobaciones.
2. Resumen semanal: decisiones, riesgos, responsables y fechas desde notas autorizadas.
3. Entrevista a insights: temas, citas, objeciones y oportunidades sin inventar evidencia.
4. Deck ejecutivo: outline, fuentes, una conclusión por slide y verificación de datos.
5. 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.md de 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. Organizá los archivos para que la IA 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.

Fuentes oficiales

• Claude Code: memoria e instrucciones, Anthropic.
• Agent Skills: formato abierto y especificación, Agent Skills.
• Skills en ChatGPT, OpenAI Help Center.
• Plugins en ChatGPT y Codex, OpenAI Help Center.
• Arquitectura de plugins, OpenAI Developers.

Si querés organizar tu forma de trabajar con IA sin convertirla en otra colección de archivos olvidados, sumate gratis a Pioneras en IA.