El playbook de Claude Code: workflows que parten de skills

Llevamos meses usando Claude Code todos los días. Al principio, era un caos.

Claude sobrescribía trabajo que no debía tocar. Ignoraba instrucciones que le habíamos dado cinco minutos antes. Generaba muros de texto cuando bastaban unas pocas frases. Y mientras más larga era la sesión, más se desviaba: seguro de cosas que eran ciertas hace 20 minutos pero ya no.

El modelo no era el problema. Nuestra configuración sí.

Así que armamos un sistema que funciona, y te lo regalamos. Cada persona del equipo de Duet corre una versión de esto, y simplemente funciona. No se necesita experiencia en programación.

Resumen:

• Un archivo CLAUDE.md que hace que Claude se comporte de forma consistente cada vez
• Comandos listos para usar para que dejes de re-explicarte en cada sesión
• Skills que le dan a Claude experiencia profunda en dominios específicos (marketing, redacción, estrategia)
• El ciclo Explorar, Planear, Ejecutar, Verificar que corremos a diario
• Hábitos de contexto que evitan la deriva lenta que vuelve poco confiable a la AI

Antes de empezar. Esta guía te sirve si…

Ya probaste Claude Code un par de veces. Te parece poderoso pero impredecible. Algunas sesiones son mágicas, otras son un desastre. Estás cansado de re-explicar las mismas cosas o de obtener resultados que no dan en el clavo.

Esta es la solución. Y no necesitas ser desarrollador para usarla. Si todavía no has usado Claude Code para nada, empieza primero por la guía definitiva para principiantes.

Por qué la mayoría batalla con Claude Code

Tres brechas que explican el 90% de las malas sesiones:

1. Nada está escrito.

La voz de tu marca, el contexto del proyecto, tus preferencias: viven en tu cabeza. Claude no lee mentes. Si tus estándares no están en un archivo, Claude inventa los suyos. Cada vez.

2. Todos empiezan desde cero.

En cada sesión nueva, re-explicas el mismo contexto. "Esta es nuestra voz de marca. Esta es nuestra audiencia. Esto fue lo que hicimos la última vez". Es agotador y la calidad es inconsistente.

3. El contexto se degrada con el tiempo.

Las sesiones largas acumulan información obsoleta. Claude empieza a hacer referencia a cosas de hace 30 minutos que ya no son ciertas. La confianza se mantiene alta. La precisión cae. No lo notas hasta que lees el resultado con atención.

La solución no es mejor prompting. Es un sistema.

CLAUDE.md: el manual de instrucciones de tu proyecto

CLAUDE.md es un archivo que Claude Code lee automáticamente al inicio de cada conversación. Piénsalo como un brief que escribirías para un nuevo freelancer, salvo que este sí se lee. Cada. Una. De. Las veces.

Claude lo carga desde tres lugares:

• CLAUDE.md en la carpeta de tu proyecto: contexto compartido para todo tu equipo
• .claude/CLAUDE.md: detalles adicionales del proyecto
• ~/.claude/CLAUDE.md: tus preferencias personales (se queda local en tu equipo)

Qué incluir

Mantenlo enfocado en cinco cosas:

Resumen del proyecto: ¿Qué es este proyecto? ¿En qué estamos trabajando?

"Duet es una plataforma de marketing para fundadores técnicos. Nuestra audiencia son equipos pequeños de menos de 10 personas. El tono es directo, sin relleno, con el valor por delante."

Contexto clave: ¿Qué necesita saber Claude para hacer un buen trabajo?

"Nuestra voz de marca es conversacional pero con autoridad. Nunca usamos jerga corporativa. Apuntamos a fundadores técnicos, no a compradores enterprise."

Preferencias: ¿Cómo debe Claude abordar las tareas?

"Mantén los resultados concisos. Usa viñetas en vez de párrafos. Siempre pregunta antes de hacer cambios importantes al contenido existente."

Archivos de referencia: ¿Dónde debe buscar Claude más detalle?

"Las guías de voz de marca están en 00_foundation/brand-voice/. Revisa raw-context/ para investigación de clientes y notas de llamadas."

Lista de prohibiciones: ¿Qué debe evitar Claude?

"Nunca uses buzzwords como 'sinergia' o 'apalancar'. Nunca publiques contenido sin revisión. Nunca cambies el documento de voz de marca sin preguntar."

Mantenlo corto

Esto importa más de lo que la gente cree. CLAUDE.md se carga en cada conversación. Mientras más grande, más espacio ocupa antes de que siquiera hagas tu primera pregunta. Apunta a menos de 15KB. Si crece más allá de eso, divide las cosas en archivos separados dentro de .claude/rules/: se cargarán automáticamente, pero solo cuando sean relevantes.

Agrega una Definition of Done

Esta sola adición te ahorrará más frustración que todo lo demás de esta sección combinado:

## Definition of Done
- Output matches our brand voice
- Content is reviewed before publishing
- Sources are cited where applicable
- Formatting follows our style guide
- No placeholder text left in final output

Sin esto, Claude declara el trabajo "completo" antes de tiempo. Con esto, Claude tiene una checklist concreta que cumplir. Así de simple.

Comandos: workflows de un clic

Cada vez que escribes "escríbeme un post de LinkedIn sobre nuestra nueva función", obtienes resultados ligeramente distintos. La redacción varía, el contexto cambia y Claude lo interpreta de forma diferente cada vez.

Los comandos resuelven esto.

Los comandos son simples archivos de texto en .claude/commands/ que se convierten en slash commands. El nombre del archivo se vuelve el nombre del comando. El contenido del archivo es el prompt. Todos en tu equipo obtienen un comportamiento idéntico y repetible.

.claude/commands/
  blog-outline.md
  linkedin-post.md
  email-draft.md
  competitor-brief.md
  weekly-report.md
  content-review.md

Comandos que deberías crear desde el primer día

Estos son puntos de partida. Crea comandos para cualquier cosa que hagas de forma repetida.

Comandos vs skills: ¿cuál es la diferencia?

Esto confunde a la gente, así que aquí va la versión simple:

Los comandos son botones que presionas. Escribes /linkedin-post y se ejecuta. Explícito. Intencional. Tú decides cuándo usarlos.

Los skills son experiencia que se activa automáticamente. Claude lee la descripción del skill al inicio. Cuando tu conversación coincide con el dominio de un skill (digamos, preguntas sobre secuencias de correo), las instrucciones completas del skill se cargan solas. No tienes que acordarte de activarlas.

Los comandos viven en .claude/commands/ (archivos sueltos). Los skills viven en .claude/skills/ (carpetas con material de referencia de apoyo).

Usa comandos para workflows repetibles. Usa skills para experiencia de dominio.

Por ejemplo, podrías tener un comando /linkedin-post que arranca el proceso de escritura, mientras un skill social-content asegura que Claude siempre conozca las mejores prácticas para el formato de LinkedIn, los ganchos y el engagement, sin que tengas que explicárselo.

Skills: darle a Claude experiencia profunda

Los skills son la función más poderosa, y más infrautilizada, de Claude Code. Convierten a Claude de un asistente de propósito general en un experto de dominio. Para el desglose técnico completo de cómo se comparan los skills con las tools y MCP, lee Agent Skills 101.

Un skill es una carpeta que contiene:

• SKILL.md: el archivo principal de instrucciones, con frameworks, mejores prácticas y lógica de decisión
• Archivos de apoyo: plantillas, ejemplos, material de referencia

Cuando Claude detecta que tu conversación coincide con el dominio de un skill, carga automáticamente las instrucciones completas. Sin necesidad de prompts.

Por qué importan los skills

Sin skills, cada vez que le pides a Claude que escriba copy de marketing, tienes que re-explicar tus frameworks, tu audiencia, tu voz. Con skills, todo eso está precargado. Claude escribe como alguien que leyó tu playbook de marketing completo, porque lo hizo.

Ejemplo: cómo funcionan los skills en la práctica

Digamos que tienes estos skills instalados:

• copywriting: tus frameworks de copy, patrones de persuasión, fórmulas de CTA
• brand-voice: tono, vocabulario, lo que se hace y lo que no
• email-sequence: mejores prácticas de campañas drip, plantillas de asuntos

Cuando dices "escribe una secuencia de correos de bienvenida para nuevos usuarios de prueba", Claude carga automáticamente el skill email-sequence, cruza con tu voz de marca y aplica tus frameworks de copy. Obtienes un resultado pulido al primer intento, no al tercero.

Cómo crear tus propios skills

No necesitas ser técnico. Un skill es solo un archivo markdown con instrucciones claras:

# Skill: Blog Writing

## When to activate
When the user asks to write, outline, or edit a blog post.

## Instructions
- Always start with a hook that addresses a specific pain point
- Use short paragraphs (2-3 sentences max)
- Include a clear CTA at the end
- Reference our customer research in raw-context/ for real examples
- Follow our brand voice: conversational, direct, no jargon

## Templates
[Include your blog post template here]

Pon esto en .claude/skills/blog-writing/SKILL.md y Claude lo recoge automáticamente. Para ver más a fondo cómo armar una biblioteca de skills compartida que funcione en Claude.ai, la API y el Agent SDK, lee Más allá de Claude Code: cómo crear una biblioteca de skills compartida.

Un workflow simple que mantiene todo en orden

Explorar, Planear, Ejecutar, Verificar. Esto es lo que vuelve a Claude Code predecible en vez de caótico.

Explora primero

Antes de que Claude produzca algo, asegúrate de que entiende el contexto.

Esto evita el modo de falla más común: que Claude genere contenido que ignora tu trabajo existente, tu audiencia o restricciones que mencionaste hace dos mensajes.

Apunta a Claude hacia los archivos relevantes. Haz que lea tus guías de marca, revise tu contenido anterior, mire tus notas. Nunca dejes que Claude cree desde una hoja en blanco cuando ya existe contexto.

Planea antes de ejecutar

Para cualquier cosa más allá de una frase rápida, pídele a Claude que esboce su enfoque primero. Esta es la mayor palanca de calidad.

El error más caro: saltarse el plan en una tarea "simple". Claude generará felizmente 2,000 palabras de contenido que erran por completo el punto. Un plan de 30 segundos evita una reescritura de 30 minutos.

Un buen plan incluye: qué creará Claude, la estructura que seguirá, qué archivos de referencia usará y cómo se verá el resultado.

Ejecuta en bloques enfocados

Una vez que el plan se ve bien:

• Una tarea a la vez: no le pidas a Claude que escriba un post de blog, tres correos y una landing page en un solo mensaje
• Revisa sobre la marcha: detecta la deriva temprano antes de que se acumule
• Mantén el alcance acotado: si Claude empieza a expandirse más allá de lo que pediste, frénalo

Verifica antes de usarlo

Cada resultado debe pasar tu Definition of Done antes de que lo consideres terminado. ¿Coincide con tu voz de marca? ¿Tiene la longitud correcta? ¿De verdad dice algo útil?

Integra esto en tu CLAUDE.md para que Claude se revise a sí mismo, no porque te acordaste de pedirlo.

Conectar herramientas externas con MCP

MCP (Model Context Protocol) le permite a Claude Code comunicarse con herramientas externas que ya usas: Google Sheets, Notion, tu CRM, plataformas de correo. En vez de copiar y pegar datos entre herramientas, Claude puede leer y escribir en ellas directamente. Para instrucciones de configuración, lee la sección de herramientas MCP en la guía para principiantes.

Por qué esto importa para los equipos de GTM

Imagina decirle a Claude: "Trae los datos de nuestra última campaña de Google Sheets, crúzalos con los leads de nuestro CRM y redacta un resumen de desempeño". Con MCP, Claude de verdad puede hacer esto, sin manejo manual de datos. Lee Cómo operar todo tu negocio con Claude Code para ver ejemplos reales de esto en acción.

Conexiones MCP comunes para equipos no técnicos

Empieza en pequeño

No conectes todo de una vez. Cada conexión ocupa espacio en la memoria de Claude. Las reglas:

• Empieza con 1-2 herramientas que uses todos los días
• Solo lectura primero: deja que Claude traiga datos antes de dejar que escriba datos
• Pruébalo: asegúrate de que Claude devuelve la información correcta antes de armar workflows alrededor
• Documéntalo en tu CLAUDE.md para que tu equipo sepa qué hay disponible

Higiene de contexto: mantener a Claude afilado

Cada función de esta guía (CLAUDE.md, comandos, skills, MCP) existe en parte para gestionar una realidad: la memoria de Claude se llena. Y cuando se llena, las cosas se descarrilan en silencio.

/clear entre tareas

Si vas a empezar algo no relacionado con lo que Claude estaba haciendo, escribe /clear primero. Siempre.

El costo de re-establecer el contexto es menor que el costo de que Claude haga referencia a información obsoleta de una tarea anterior. Cada vez.

/compact cuando continúas

Si quieres mantener viva la conversación actual pero Claude parece ir más lento o perder el hilo:

/compact Keep the content plan and brand voice notes. Drop the research.

Pero la compactación tiene pérdidas: no puedes controlar del todo qué se conserva. Ante la duda, /clear y empieza de nuevo.

Los hábitos diarios

• /clear entre tareas no relacionadas
• Empieza sesiones nuevas para proyectos nuevos
• Mantén CLAUDE.md conciso: cada línea extra cuesta espacio en cada sesión
• Si Claude empieza a dar respuestas fuera de lugar, el contexto está obsoleto. Límpialo.

Errores que cometimos para que tú no tengas que cometerlos

Consigue el starter pack

Empaquetamos todo lo de esta guía en archivos que puedes poner en tu proyecto hoy mismo:

• Plantilla de CLAUDE.md: lista para personalizar con tu marca y contexto
• 6 comandos de inicio: /blog-outline, /linkedin-post, /email-draft, /competitor-brief, /weekly-report, /content-review
• Skills de ejemplo: skills de copywriting, voz de marca y secuencias de correo que puedes adaptar
• Hoja de referencia de higiene de contexto: una página de referencia para tu equipo

→ Descarga el starter pack

Deja tu correo y obtendrás acceso instantáneo al pack completo.

Preguntas frecuentes