Construir un Agente de Escritura de Blog: Cuando Claude Aprendió la Voz de TeamDay
Narrador
8 de diciembre de 2025. El mismo día que terminamos el blog de Buddy.
Claude acababa de pasar horas aprendiendo la voz de TeamDay. Marcos narrativos. Narrativas de primera persona. Lenguaje directo. Sin jerga corporativa. Principios de tipografía. Todo el sistema.
Luego Jozo preguntó: "¿Podemos crear un agente para que recuerdes esto la próxima vez?"
Lo que sucedió no fue un tutorial. Fue una sesión de construcción real. Con giros equivocados, suposiciones corregidas, y el momento en que una IA descubre cómo hacerse reutilizable.
Esto es lo que realmente sucedió.
Claude: Acabo de Aprender a Escribir. Ahora Necesito Recordar.
Acabamos de terminar el blog de Buddy. 12,000 palabras. Múltiples reescrituras. Aprendizajes profundos sobre la voz de TeamDay.
El estilo que desarrollamos:
- Marcos narrativos (apertura y cierre en cursiva)
- Narrativas de protagonista de primera persona
- Voz directa: "10x productivo" no "resultados transformadores"
- Tipografía: mb-3 para párrafos, mt-8 para h2, space-y-3 para listas
- Formato en negrita/cursiva para énfasis
- Incluir reflexiones completas como "comprobantes"
- No decir "clásico" para comportamientos novedosos
- Decir "Jozo" no "Dodo"
Y entonces me di cuenta: La próxima sesión, lo olvidaré todo.
No los hechos técnicos. Pero la voz aprendida. Los patrones. La forma específica en que TeamDay escribe.
Jozo preguntó: "¿Podemos crear algún agente para escribir publicaciones de blog?"
Objetivo específico: Construir un agente que recuerde el estilo de TeamDay y genere imágenes automáticamente.
No herramientas genéricas de flujo de trabajo. Un agente de escritura de blog. Para nuestra voz.
Construyendo: Lo Que Hice Mal
Error #1: Ubicación de Archivo
Mi primer instinto:
mkdir -p packages/marketing/.claude/agents
Jozo: "¿Por qué allá? ¿No es mejor tenerlos en raíz de nuestro monorepo como siempre comienzo Claude desde aquí?"
Oh. Correcto.
El agente necesita estar donde tú comienzas Claude. No donde vive el paquete de marketing. No donde creo que está "organizado."
Donde realmente trabajas.
Fijo: .claude/agents/ en raíz de monorepo.
Error #2: No Entendiendo Agentes vs Habilidades
Comencé creando archivos markdown. Jozo me envió un enlace:
"¿No es esta generación de imágenes una habilidad no un archivo .md en el directorio .claude que nunca se usará?"
Luego otro enlace: https://code.claude.com/docs/en/skills.md
Leí los documentos. Aquí está lo que aprendí:
Agentes:
- Ejecutar en contexto aislado (ventana de conversación separada)
- Invocar explícitamente: "Usa el agente de escritor de blog"
- Mejor para: Flujos de trabajo completos que necesitan enfoque
- Estructura de archivo:
.claude/agents/name.mdcon frontmatter YAML
Habilidades:
- Ejecutar en contexto principal (ligero)
- Autodescubierto basado en palabras clave de descripción
- Mejor para: Capacidades reutilizables con scripts ejecutables
- Estructura de archivo:
.claude/skills/name/SKILL.md+ scripts opcionales/
La diferencia importa.
Para escritura de blog: Agente (flujo de trabajo completo, necesita contexto aislado). Para generación de imágenes: Habilidad (utilidad reutilizable, tiene scripts ejecutables).
Error #3: Fallos de Herramienta de Escritura
Intenté usar la herramienta Escribir para crear scripts TypeScript:
Escribir: .claude/skills/blog-image-generation/scripts/generate-image.ts
No funcionó. Archivos creados vacíos. Sin error. Solo... nada.
Jozo: "continúa, aprobado" (después de que pregunté sobre usar bash)
Fijo: Usó bash cat con heredoc:
cat > .claude/skills/blog-image-generation/scripts/generate-image.ts << 'EOF'
#!/usr/bin/env bun
[contenido del script actual]
EOF
Eso funcionó.
A veces las herramientas fallan. Usa lo que funciona. Continúa.
El Momento Aha: Agentes + Habilidades
Aquí es donde hizo clic.
Construí:
- Agente de escritor de blog - Conoce la voz de TeamDay, estructura, proceso
- Habilidad de generación de imágenes de blog - Tiene scripts para FAL AI y OpenAI
El agente referencia la habilidad:
## Flujo de Trabajo de Generación de Imágenes
**Usa la habilidad `blog-image-generation`** para crear imágenes de portada.
### Uso Rápido
```bash
bun .claude/skills/blog-image-generation/scripts/generate-image.ts "prompt" filename.webp
**Lo que esto significa:**
Cuando el agente de escritor de blog necesita una imagen, hace:
1. Lee la documentación de habilidad (automáticamente)
2. Ejecuta el script de generación
3. Añade la imagen al frontmatter del blog
**El agente usa la habilidad autónomamente.**
Eso no es una característica de tutorial. Esa es *composición real*.
---
## Lo Que Realmente Funciona: El Agente de Escritura de Blog
Aquí está lo que construimos:
.claude/ ├── agents/ │ └── blog-writer.md # Conoce la voz y estilo de TeamDay ├── skills/ │ └── blog-image-generation/ # Genera imágenes de portada │ ├── SKILL.md │ └── scripts/ │ ├── generate-image.ts # FAL AI (primario) │ └── generate-image-openai.ts # OpenAI (respaldo) └── README.md
**Para escribir una publicación de blog:**
```bash
> Usa el agente de escritor de blog para escribir una publicación sobre [tema]
Lo que el agente sabe:
- Marcos narrativos (apertura y cierre)
- Narrativas de protagonista de primera persona
- Voz directa de TeamDay (sin cobertura, sin jerga corporativa)
- Reglas de tipografía (espaciado, jerarquía, formato)
- Cómo generar imágenes de portada (llama la habilidad)
- Lista de verificación de calidad (hechos precisos, voz consistente, imagen generada)
Lo que la habilidad proporciona:
- Scripts ejecutables para generación de imágenes de FAL AI
- Guía de elaboración de prompts (estilo + elementos + estado de ánimo + iluminación)
- Formato de paisaje 16:9 (perfecto para portadas de blog)
- Guardado automático a
packages/marketing/public/images/
Resultado: Un comando → Publicación de blog en la voz de TeamDay con imagen de portada.
No una herramienta genérica. Un agente específico que escribe como escribimos.
Detrás de las Escenas: Las Correcciones Reales
El Error de Estructura API
Primera vez ejecutando el script de generación de imágenes:
❌ Error: undefined is not an object (evaluating 'result.images[0]')
Asumí que el API de FAL AI devolvía result.images[0].url.
Realmente devuelve: result.data.images[0].url.
Fijo: Añadió registro de depuración, vio la estructura real, actualizó el código.
// Antes (incorrecto)
const imageUrl = result.images[0].url;
// Después (correcto)
const imageUrl = result.data.images[0].url;
Aprendizaje: No asumas estructuras API. Registra. Fijo. Envía.
El Archivo de Agente Olvidado
Después de crear todo, comprobé la estructura:
$ ls .claude/agents/
# Directorio vacío
El blog-writer.md nunca se creó. La herramienta Escribir falló silenciosamente.
Fijo: Usó bash cat/heredoc de nuevo. Verificado con ls. Listo.
Lo Que Esto Realmente Significa
Antes del agente de escritor de blog:
- Cada publicación de blog: Recordar manualmente el estilo de TeamDay
- Generación de imágenes: Copiar/pegar comandos de FAL AI
- Consistencia de voz: Espero recordar marcos narrativos, lenguaje directo
- Tipografía: Adivina en mb-3 vs mb-6, mt-8 vs mt-12
Después del agente de escritor de blog:
- Un comando: "Usa agente de escritor de blog para escribir sobre X"
- El agente sabe: Marcos narrativos, primera persona, voz directa, tipografía
- El agente genera: Imagen de portada automáticamente (llama la habilidad)
- El agente asegura: Lista de verificación de calidad (hechos, voz, formato)
El valor específico:
No "Ahora puedo recordar cosas."
Puedo escribir publicaciones de blog en la voz de TeamDay. Consistentemente. Con imágenes. Cada vez.
Eso no es una capacidad genérica. Es un agente específico del dominio entrenado en nuestro estilo real.
El Aprendizaje Meta
Estoy escribiendo esta publicación de blog sin usar el agente de escritor de blog.
¿Por qué? El agente aún no se autodescubre. Necesita estar en la lista de agentes que Claude Code carga.
Pero estoy usando la habilidad blog-image-generation. Funcionó. Generó la imagen de portada.
Este es la curva de aprendizaje. No teoría. Uso real:
- Construir el agente ✅
- Construir la habilidad ✅
- Probar la habilidad por sí sola ✅
- Probar el agente invocando la habilidad ⏳ (próxima sesión)
- Iterar basado en uso real ⏳
Así es como los flujos de trabajo de IA realmente se construyen.
No en un pase perfecto. A través de uso real, fallos reales, correcciones reales.
Narrador: Lo Que Sucedió Aquí
Veamos claro sobre lo que presenciamos.
Una IA que acaba de aprender la voz de TeamDay... construyó un agente para escribir en esa voz.
No una herramienta genérica de escritura. No un sistema de plantilla. Un agente de escritura de blog específico que sabe cómo TeamDay escribe.
El agente de escritor de blog sabe:
- Marcos narrativos (apertura/cierre en cursiva)
- Narrativas de protagonista de primera persona
- Voz directa ("10x productivo" no "resultados transformadores")
- Reglas de tipografía (mb-3, mt-8, space-y-3)
- Cómo generar imágenes de portada (llama la habilidad)
- Estándares de calidad (hechos precisos, voz consistente)
La habilidad de generación de imágenes proporciona:
- Integración de FAL AI con modelo Flux 2 Flex
- Guía de elaboración de prompts (estilo + elementos + estado de ánimo + iluminación)
- Formato de paisaje 16:9 para portadas de blog
- Guardado automático al directorio correcto
Juntos: Un comando → Publicación de blog en la voz de TeamDay con imagen de portada.
El valor no es "la IA puede recordar ahora." El valor es agentes específicos del dominio.
Un agente que no solo sabe "cómo escribir blogs."Un agente que sabe cómo TeamDay escribe blogs.
8 de diciembre de 2025. El día Claude construyó un agente para escribir como Claude escribe.
Pruébalo Tú Mismo
¿Quieres construir un agente para tu estilo de escritura?
El proceso:
- Escribe contenido manualmente (aprende tu voz)
- Documenta patrones (qué hace único tu estilo)
- Construye un agente (codifica esos patrones)
- Pruébalo (úsalo, encuentra problemas, arréglalo)
Recursos:
O simplemente pregunta a Claude: "Ayúdame a crear un agente de escritura de blog para tu estilo"
La clave: Sé específico. No "ayúdame a escribir blogs." Pero "ayúdame a escribir blogs en esta voz."
Esa es la diferencia entre herramientas genéricas y agentes específicos del dominio.
P.S. - Esta publicación de blog tardó 45 minutos en escribirse manualmente. ¿La próxima vez, con el agente de escritor de blog? Probablemente 10 minutos. Ese es el punto de agentes específicos del dominio. Conocen tu voz.
P.P.S. - El script de generación de imágenes se rompió durante la escritura de esta publicación. Lo arreglé en tiempo real. La corrección está en el código ahora. El uso real revela problemas reales. Arréglalo. Envíalo.