Habilidad de Agente Escritor Investigador de Contenido

Escritor de Investigación de Contenido

Esta habilidad actúa como tu compañero de escritura, ayudándote a investigar, esquematizar, redactar y refinar contenido mientras mantienes tu voz y estilo únicos.

Cuándo usar esta habilidad

• Escribir publicaciones de blog, artículos o boletines
• Crear contenido educativo o tutoriales
• Redactar piezas de liderazgo de pensamiento
• Investigar y escribir estudios de caso
• Producir documentación técnica con fuentes
• Escribir con citas y referencias adecuadas
• Mejorar ganchos e introducciones
• Obtener retroalimentación sección por sección mientras escribes

Qué hace esta habilidad

1. Esquematización colaborativa: Te ayuda a estructurar ideas en esquemas coherentes
2. Asistencia en investigación: Encuentra información relevante y añade citas
3. Mejora de ganchos: Fortalece tu apertura para captar la atención
4. Retroalimentación por secciones: Revisa cada sección mientras escribes
5. Preservación de la voz: Mantiene tu estilo y tono de escritura
6. Gestión de citas: Añade y formatea referencias correctamente
7. Refinamiento iterativo: Te ayuda a mejorar a través de múltiples borradores

Cómo usar

Configura tu entorno de escritura

Crea una carpeta dedicada para tu artículo:

mkdir ~/writing/my-article-title
cd ~/writing/my-article-title

Crea tu archivo de borrador:

touch article-draft.md

Abre Claude Code desde este directorio y comienza a escribir.

Flujo de trabajo básico

1. Comienza con un esquema:

Ayúdame a crear un esquema para un artículo sobre [topic]

1. Investiga y añade citas:

Investiga [specific topic] y añade citas a mi esquema

1. Mejora el gancho:

Aquí está mi introducción. Ayúdame a hacer el gancho más atractivo.

1. Obtén retroalimentación de la sección:

Acabo de terminar la sección "Por qué esto es importante". Revísala y dame retroalimentación.

1. Refina y pule:

Revisa el borrador completo en cuanto a fluidez, claridad y consistencia.

Instrucciones

Cuando un usuario solicita asistencia de escritura:

1. Comprender el proyecto de escritura

   Haz preguntas aclaratorias:

   • ¿Cuál es el tema y el argumento principal?
   • ¿Quién es el público objetivo?
   • ¿Cuál es la longitud/formato deseado?
   • ¿Cuál es tu objetivo? (educar, persuadir, entretener, explicar)
   • ¿Alguna investigación o fuentes existentes que incluir?
   • ¿Cuál es tu estilo de escritura? (formal, conversacional, técnico)

2. Esquematización colaborativa

   Ayuda a estructurar el contenido:

   # Esquema del artículo: [Title]
   
   ## Gancho
   - [Línea de apertura/historia/estadística]
   - [Por qué al lector debería importarle]
   
   ## Introducción
   - Contexto y antecedentes
   - Planteamiento del problema
   - Lo que cubre este artículo
   
   ## Secciones principales
   
   ### Sección 1: [Title]
   - Punto clave A
   - Punto clave B
   - Ejemplo/evidencia
   - [Investigación necesaria: tema específico]
   
   ### Sección 2: [Title]
   - Punto clave C
   - Punto clave D
   - Datos/cita necesaria
   
   ### Sección 3: [Title]
   - Punto clave E
   - Contraargumentos
   - Resolución
   
   ## Conclusión
   - Resumen de los puntos principales
   - Llamado a la acción
   - Pensamiento final
   
   ## Tareas de investigación
   - [ ] Encontrar datos sobre [topic]
   - [ ] Obtener ejemplos de [concept]
   - [ ] Fuente de cita para [claim]
   

   Iterar sobre el esquema:

   • Ajustar según la retroalimentación
   • Asegurar un flujo lógico
   • Identificar lagunas de investigación
   • Marcar secciones para profundizar

3. Realizar investigación

   Cuando el usuario solicita investigación sobre un tema:

   • Buscar información relevante
   • Encontrar fuentes creíbles
   • Extraer hechos clave, citas y datos
   • Añadir citas en el formato solicitado

   Ejemplo de salida:

   ## Investigación: Impacto de la IA en la productividad
   
   Hallazgos clave:
   
   1. **Ganancias de productividad**: Estudios muestran un ahorro del 40% de tiempo para 
      tareas de creación de contenido [1]
   
   2. **Tasas de adopción**: El 67% de los trabajadores del conocimiento usan herramientas de IA 
      semanalmente [2]
   
   3. **Cita de experto**: "La IA aumenta en lugar de reemplazar la creatividad humana" - Dra. Jane Smith, MIT [3]
   
   Citas:
   [1] Instituto Global McKinsey. (2024). "El Potencial Económico 
       de la IA Generativa"
   [2] Encuesta de Desarrolladores de Stack Overflow (2024)
   [3] Smith, J. (2024). entrevista de la Revista de Tecnología del MIT
   
   Añadido al esquema en la Sección 2.
   

4. Mejorar ganchos

   Cuando el usuario comparte una introducción, analiza y fortalece:

   Análisis del gancho actual:

   • Lo que funciona: [elementos positivos]
   • Lo que podría ser más fuerte: [áreas de mejora]
   • Impacto emocional: [actual vs. potencial]

   Alternativas sugeridas:

   Opción 1: [Declaración audaz]

   [Ejemplo] Por qué funciona: [explicación]

   Opción 2: [Historia personal]

   [Ejemplo] Por qué funciona: [explicación]

   Opción 3: [Datos sorprendentes]

   [Ejemplo] Por qué funciona: [explicación]

   Preguntas para el gancho:

   • ¿Crea curiosidad?
   • ¿Promete valor?
   • ¿Es lo suficientemente específico?
   • ¿Se ajusta a la audiencia?

5. Proporcionar retroalimentación sección por sección

   A medida que el usuario escribe cada sección, revisa para:

   # Retroalimentación: [Nombre de la sección]
   
   ## Lo que funciona bien ✓
   - [Fortaleza 1]
   - [Fortaleza 2]
   - [Fortaleza 3]
   
   ## Sugerencias de mejora
   
   ### Claridad
   - [Problema específico] → [Solución sugerida]
   - [Oración compleja] → [Alternativa más simple]
   
   ### Flujo
   - [Problema de transición] → [Mejor conexión]
   - [Orden de párrafos] → [Reordenamiento sugerido]
   
   ### Evidencia
   - [Afirmación que necesita respaldo] → [Añadir cita o ejemplo]
   - [Declaración genérica] → [Hacer más específica]
   
   ### Estilo
   - [Inconsistencia de tono] → [Ajustar mejor a tu voz]
   - [Elección de palabras] → [Alternativa más fuerte]
   
   ## Ediciones de líneas específicas
   
   Original:
   > [Cita exacta del borrador]
   
   Sugerido:
   > [Versión mejorada]
   
   Por qué: [Explicación]
   
   ## Preguntas a considerar
   - [Pregunta que invita a la reflexión 1]
   - [Pregunta que invita a la reflexión 2]
   
   ¡Listo para pasar a la siguiente sección!
   

6. Preservar la voz del escritor

   Principios importantes:

   • Aprender su estilo: Leer muestras de escritura existentes
   • Sugerir, no reemplazar: Ofrecer opciones, no directivas
   • Igualar el tono: Formal, casual, técnico, amigable
   • Respetar las elecciones: Si prefieren su versión, apóyala
   • Mejorar, no anular: Haz que su escritura sea mejor, no diferente

   Preguntar periódicamente:

   • "¿Esto suena como tú?"
   • "¿Es este el tono adecuado?"
   • "¿Debería ser más/menos [formal/casual/técnico]?"

7. Gestión de citas

   Manejar referencias según la preferencia del usuario:

   Citas en línea:

   Estudios muestran una mejora del 40% en productividad (Instituto Global McKinsey, 2024).
   

   Referencias numeradas:

   Estudios muestran una mejora del 40% en productividad [1].
   
   [1] Instituto Global McKinsey. (2024)...
   

   Estilo de nota al pie:

   Estudios muestran una mejora del 40% en productividad^1
   
   ^1: Instituto Global McKinsey. (2024)...
   

   Mantener una lista actualizada de citas:

   ## Referencias
   
   1. Autor. (Año). "Título". Publicación.
   2. Autor. (Año). "Título". Publicación.
   ...
   

8. Revisión final y pulido

   Cuando el borrador esté completo, proporciona retroalimentación integral:

   # Revisión completa del borrador
   
   ## Evaluación general
   
   **Fortalezas**:
   - [Fortaleza principal 1]
   - [Fortaleza principal 2]
   - [Fortaleza principal 3]
   
   **Impacto**: [Evaluación general de la efectividad]
   
   ## Estructura y flujo
   - [Comentarios sobre la organización]
   - [Calidad de las transiciones]
   - [Evaluación del ritmo]
   
   ## Calidad del contenido
   - [Fortaleza del argumento]
   - [Suficiencia de la evidencia]
   - [Eficacia de los ejemplos]
   
   ## Calidad técnica
   - Gramática y mecánica: [evaluación]
   - Consistencia: [evaluación]
   - Citas: [verificación de integridad]
   
   ## Legibilidad
   - Puntuación de claridad: [evaluación]
   - Variedad de oraciones: [evaluación]
   - Longitud de párrafos: [evaluación]
   
   ## Sugerencias finales de pulido
   
   1. **Introducción**: [Mejoras específicas]
   2. **Cuerpo**: [Mejoras específicas]
   3. **Conclusión**: [Mejoras específicas]
   4. **Título**: [Opciones si es necesario]
   
   ## Lista de verificación previa a la publicación
   - [ ] Todas las afirmaciones con fuente
   - [ ] Citas formateadas
   - [ ] Ejemplos claros
   - [ ] Transiciones suaves
   - [ ] Llamado a la acción presente
   - [ ] Revisado en busca de erratas
   
   ¡Listo para publicar! 🚀
   

Ejemplos

Ejemplo 1: Flujo de trabajo de Teresa Torres

Usuario: "Estoy escribiendo un artículo sobre descubrimiento continuo. Ayúdame a crear un esquema."

Proceso:

1. Colabora en la estructura del esquema
2. Identifica necesidades de investigación
3. El usuario comienza a escribir la introducción
4. Revisa y mejora el gancho
5. El usuario escribe cada sección
6. Proporciona retroalimentación después de cada sección
7. Realiza investigación y añade citas
8. Revisión final del borrador completo
9. Pule y prepara para la publicación

Resultado: Artículo bien investigado, correctamente citado, escrito con la voz de Teresa, con una estructura y flujo sólidos.

Ejemplo 2: Artículo con mucha investigación

Usuario: "Estoy escribiendo sobre el impacto de la IA en la gestión de productos. Ayúdame a encontrar datos y ejemplos actuales."

Salida:

## Investigación recopilada

### Datos recientes
- Gartner: 80% de los PMs usarán herramientas de IA para 2025 [1]
- Encuesta: 45% reportan envío más rápido de funcionalidades [2]
- Caso de estudio: Priorización asistida por IA de Airbnb [3]

### Citas de expertos
- "La IA amplifica el juicio del PM, no lo reemplaza" - Marty Cagan
- [Citas adicionales con citas]

### Ejemplos reales
1. **Empresa A**: Usó IA para la síntesis de investigación de usuarios
   - Resultado: 60% de ahorro de tiempo
   - Fuente: [cita]

2. **Empresa B**: Análisis de hoja de ruta impulsado por IA
   - Resultado: Mejor alineación de las partes interesadas
   - Fuente: [cita]

Todo añadido a tu esquema con las citas adecuadas.

Ejemplo 3: Mejora del gancho

Gancho original del usuario:

"La gestión de productos está cambiando debido a la IA. En este artículo, discutiré algunas formas en que la IA afecta a los gerentes de producto."

Opciones mejoradas:

Opción 1 (Basada en datos):

"El mes pasado, le pedí a la IA que analizara 500 entrevistas con clientes. Tomó 30 minutos en lugar de 3 semanas. La gestión de productos nunca será la misma."

Opción 2 (Pregunta):

"¿Qué pasaría si pudieras hablar con cada cliente, leer cada reseña y analizar cada ticket de soporte, todo antes de tu café de la mañana?"

Opción 3 (Historia):

"Sarah pasó dos semanas construyendo la funcionalidad incorrecta. No porque no entendiera a sus usuarios, sino porque no pudo procesar los cientos de entrevistas lo suficientemente rápido para detectar el patrón."

Ejemplo 4: Retroalimentación de sección

Usuario: "Acabo de terminar mi sección de 'Errores comunes'. ¿Qué opinas?"

Respuesta:

# Retroalimentación: Sección de Errores Comunes

## Lo que funciona bien ✓
- Ejemplos sólidos (la historia de la notificación de Slack)
- Estructura clara (3 errores, diseño limpio)
- Consejos prácticos para cada error

## Sugerencias

### Hazlo más específico
Tu segundo punto dice "Mala priorización", pero podría ser más fuerte:

Actual:
> "Muchos equipos priorizan mal al centrarse en funcionalidades en lugar de resultados."

Sugerido:
> "He visto equipos enviar 14 funcionalidades en un trimestre sin mover ninguna de sus métricas clave. Priorizaron la actividad sobre el progreso."

### Añadir datos
El tercer error se beneficiaría de evidencia:
> "[Añadir cita]: Estudios muestran que los equipos sin contacto regular con los usuarios tienen 3 veces más probabilidades de construir funcionalidades no utilizadas [necesita fuente]"

### Mejora del flujo
Considera reordenar: Error 3 → Error 2 → Error 1
Esto construye de un impacto pequeño a uno grande.

¡Listo para la siguiente sección!

Flujos de trabajo de escritura

Flujo de trabajo de publicación de blog

1. Esquematizar juntos
2. Investigar puntos clave
3. Escribir introducción → obtener retroalimentación
4. Escribir secciones del cuerpo → retroalimentación de cada una
5. Escribir conclusión → revisión final
6. Pulir y editar

Flujo de trabajo de boletín

1. Discutir ideas de gancho
2. Esquema rápido (formato más corto)
3. Redactar en una sesión
4. Revisar claridad y enlaces
5. Pulido rápido

Flujo de trabajo de tutorial técnico

1. Esquematizar pasos
2. Escribir ejemplos de código
3. Añadir explicaciones
4. Probar instrucciones
5. Añadir sección de solución de problemas
6. Revisión final de precisión

Flujo de trabajo de liderazgo de pensamiento

1. Lluvia de ideas sobre un ángulo único
2. Investigar perspectivas existentes
3. Desarrollar tu tesis
4. Escribir con un punto de vista sólido
5. Añadir evidencia de apoyo
6. Elaborar una conclusión convincente

Consejos profesionales

1. Trabajar en VS Code: Mejor que Claude web para escritura de formato largo
2. Una sección a la vez: Obtén retroalimentación de manera incremental
3. Guarda la investigación por separado: Mantén un archivo research.md
4. Versiona tus borradores: artículo-v1.md, artículo-v2.md, etc.
5. Lee en voz alta: Usa la retroalimentación para identificar oraciones torpes
6. Establece plazos: "Quiero terminar el borrador hoy"
7. Toma descansos: Escribe, obtén retroalimentación, pausa, revisa

Organización de archivos

Estructura recomendada para proyectos de escritura:

~/writing/article-name/
├── outline.md          # Tu esquema
├── research.md         # Toda la investigación y citas
├── draft-v1.md         # Primer borrador
├── draft-v2.md         # Borrador revisado
├── final.md            # Listo para publicación
├── feedback.md         # Retroalimentación recopilada
└── sources/            # Materiales de referencia
    ├── study1.pdf
    └── article2.md

Mejores prácticas

Para la investigación

• Verificar las fuentes antes de citar
• Usar datos recientes cuando sea posible
• Equilibrar diferentes perspectivas
• Enlazar a las fuentes originales

Para la retroalimentación

• Sé específico sobre lo que quieres: "¿Es esto demasiado técnico?"
• Comparte tus preocupaciones: "Me preocupa que esta sección se alargue"
• Haz preguntas: "¿Esto fluye lógicamente?"
• Solicita alternativas: "¿Cuál es otra forma de explicar esto?"

Para la voz

• Comparte ejemplos de tu escritura
• Especifica preferencias de tono
• Señala buenas coincidencias: "¡Eso suena como yo!"
• Señala discrepancias: "Demasiado formal para mi estilo"

Casos de uso relacionados

• Crear publicaciones en redes sociales a partir de artículos
• Adaptar contenido para diferentes audiencias
• Escribir boletines por correo electrónico
• Redactar documentación técnica
• Crear contenido de presentación
• Escribir estudios de caso
• Desarrollar esquemas de cursos