voz-boletín

Voz para Boletín

Entorno de ejecución Codex y Claude

• Usa este skill en Codex o Claude con las herramientas realmente disponibles en la tarea actual. Los ejemplos de AskUserQuestion describen las preguntas, no una API requerida: usa una herramienta de preguntas disponible dentro de sus límites, o pregunta en el chat. Reutiliza respuestas y material fuente ya proporcionado.
• Trabaja en el proyecto seleccionado por el usuario. Lee su about-me.md, voice.md y los archivos de marca relevantes antes del trabajo personalizado. Confirma el autor previsto si los archivos entran en conflicto o contienen valores predeterminados de inicio. Pregunta por datos faltantes o ejecuta voice-builder; nunca heredes la identidad, cuentas o archivos privados del mantenedor.
• Resuelve los references/ empaquetados de forma relativa a esta carpeta del skill. Para una actualización de perfil solicitada explícitamente, lee y actualiza el about-me.md, voice.md o newsletter-voice.md canónico en su lugar, preservando hechos y reglas del usuario no relacionados. Los consumidores deben volver a leer esos archivos canónicos. Usa un nombre de archivo nuevo solo para entregables nuevos que colisionarían con archivos existentes no relacionados. La instalación por sí sola nunca inicia una entrevista ni escribe archivos. No escribas aprendizajes persistentes a menos que se solicite.
• Usa primero la evidencia proporcionada. Verifica afirmaciones externas a través de herramientas de búsqueda/fuente disponibles cuando sea necesario. Si una fuente o integración no está disponible, nombra la capacidad faltante y ofrece entrada de texto/exportación proporcionada. Nunca inventes hechos, experiencia en primera persona, métricas o una ejecución exitosa de herramienta.
• Conecta solo los servicios necesarios para la ruta elegida a través de la cuenta existente del usuario. Nunca imprimas credenciales ni sobrescribas conexiones. Redactar, guardar y revisar no autorizan publicar, enviar mensajes o cambiar cuentas.

Verificación de requisitos previos

En el momento en que se active este skill, verifica en la raíz del proyecto la existencia de voice.md y about-me.md.

Si falta alguno de los archivos, dile al usuario:

La voz del boletín se apoya en tu perfil de voz general. Ejecuta primero voice-builder (sube el skill o di "construye mi voz"), luego vuelve aquí una vez que about-me.md y voice.md estén en el proyecto.

Luego detente. No continúes hasta que ambos archivos existan.

Si ambos archivos existen, léelos por completo, luego ve directamente al Paso 1.

Paso 1. Verificar muestras

Pregunta al usuario en el chat:

¿Tienes de 2 a 3 boletines pasados de los que pueda aprender?

Sí: pégalos aquí (uno por mensaje o todos juntos) No: escribe "arquetipo" y construiré a partir de una plantilla ajustada a tu voz

Espera respuesta.

Si el usuario pega 2 o más boletines, ve al Paso 2a. Si el usuario escribe "arquetipo", ve al Paso 2b. Si el usuario pega 1 boletín, pide al menos uno más. Si solo tiene uno, ofrécele: "Una muestra no es suficiente para detectar patrones. ¿Quieres que cambie al modo arquetipo y use tu único boletín como punto de referencia?"

Paso 2a. Análisis basado en muestras

Lee cada boletín por completo. Busca patrones entre números, no peculiaridades aisladas. Extrae:

Fórmula de apertura

• Qué hacen las primeras 3 oraciones (resultado específico, observación cultural, afirmación, escena, pregunta)
• Longitud de la sección de apertura antes de la primera pausa estructural
• Movimiento de credibilidad (cómo el autor establece autoridad temprano)
• Promesa de valor (qué se le dice al lector que obtendrá)

Estructura de secciones

• Planteamiento de problema o contraste
• Marco nombrado o prosa libre
• Pasos numerados, métodos o argumento continuo
• Patrones de ejemplos y evidencia
• Sección extra o ampliación
• Fórmula de cierre y despedida

Filosofía de datos

• Números específicos por número (cuéntalos)
• Estilo de atribución de fuentes (enlazado, nombrado, sin crédito)
• Relación ejemplo-abstracción
• Reconocimientos de limitaciones o fallos

Formato

• Uso de encabezados (frecuencia, jerarquía)
• Uso de listas (numeradas, con viñetas, flechas)
• Uso de negritas y cursivas
• Formato de indicaciones, bloques de código o citas en bloque
• Marcadores visuales (flechas, marcas de verificación, emojis si los hay)

Longitud

• Rango de recuento de palabras entre muestras
• Recuento de palabras por sección

Marcadores de voz únicos del formato boletín

• Consejos o llamadas destacadas (frecuencia, formato)
• Cierres orientados al futuro
• Frase de despedida si es consistente entre muestras
• Meta-transparencia (¿el autor reflexiona sobre el proceso o pide retroalimentación?)

Señales de ausencia

• Palabras, construcciones o estructuras ausentes en todas las muestras
• Movimientos de cierre que el autor nunca usa
• Temas que el autor nunca toca

Luego ve al Paso 3.

Paso 2b. Selección de arquetipo

Llama a la herramienta AskUserQuestion con una sola pregunta:

[
  {
    "question": "¿Qué arquetipo de boletín se ajusta a lo que quieres escribir?",
    "header": "Arquetipo",
    "multiSelect": false,
    "options": [
      {"label": "Tutorial de datos", "description": "Números, marcos, métodos paso a paso con indicaciones"},
      {"label": "Ensayo polémico", "description": "Toma una posición, defiéndela, nombra a la oposición"},
      {"label": "Análisis de caso de estudio", "description": "Un tema por número, analizado en profundidad"},
      {"label": "Resumen curado", "description": "5 a 7 enlaces con tu comentario cada semana"},
      {"label": "Ensayo personal", "description": "Reflexión sobre un tema, priorizando la narrativa"},
      {"label": "Entrevista o perfil", "description": "Una persona por número, preguntas y respuestas o narrativa"}
    ]
  }
]

Después de que el usuario elija un arquetipo, carga los valores predeterminados correspondientes de references/archetypes.md dentro de esta carpeta del skill. Ajusta cada campo usando voice.md y about-me.md antes de escribir newsletter-voice.md. Marca dentro del archivo de salida que se usaron valores predeterminados de arquetipo y que el archivo debe revisarse después de 5 números publicados.

Paso 3. Escribir newsletter-voice.md

Crea newsletter-voice.md en la raíz del proyecto. Archivo único, con objetivo de 800 a 1200 palabras. Usa esta estructura:

# Voz para Boletín

## Fuente
[Basado en muestras: analizados X números de boletín] O [Basado en arquetipo: [nombre del arquetipo] ajustado a voice.md. Revisar después de 5 números publicados.]

## Audiencia y propósito
[Quién lee este boletín y qué obtiene de él. Escrito a partir de about-me.md y voice.md. 2 a 3 oraciones.]

## Principios de voz
[3 a 5 principios fundamentales que la escritura siempre mantiene. Cada uno una oración declarativa corta. Ajustados al voice.md de este usuario.]

## Fórmula de apertura
[Cómo comienzan los números. Incluye 2 plantillas concretas con marcadores de posición entre corchetes, por ejemplo: "[Resultado específico con número]. [Marcador de credibilidad]. [Promesa de valor para este número]." Recuento de palabras objetivo para la sección de apertura.]

## Flujo de secciones
[Estructura estándar de un número, sección por sección, máximo 5 a 8 secciones. Notas breves sobre qué hace cada sección y cuánto dura.]

## Datos y evidencia
[Cómo se usan los números y ejemplos. Reglas específicas, por ejemplo: "cada afirmación necesita un número", "fuentes enlazadas en línea", "relación ejemplo-abstracción aproximadamente 3:1".]

## Reglas de formato
[Encabezados, listas, negritas, cursivas, bloques de código, marcadores visuales. Qué usar, qué evitar. Extraído de muestras o valores predeterminados de arquetipo.]

## Cierre y despedida
[Cómo terminan los números. Declaración orientada al futuro versus resumen. Frase de despedida si existe una consistente entre las muestras (no inventes una).]

## Lo que este boletín nunca hace
[1 párrafo corto o 3 a 5 elementos. Extraído de patrones de ausencia entre muestras o valores predeterminados de arquetipo. Solo comportamientos, no una lista de palabras prohibidas.]

## Longitud
[Recuento de palabras objetivo para números estándar. Objetivo separado para guías exhaustivas más largas si el usuario escribe ambos formatos.]

Llena cada sección a partir de las muestras (o valores predeterminados de arquetipo ajustados). Sin relleno genérico. Si las muestras no cubren algo, di "no hay un patrón claro entre las muestras" en lugar de adivinar.

Paso 4. Confirmar y entregar

Dile al usuario:

Tu voz para boletín está construida. newsletter-voice.md está en la raíz de tu proyecto junto a about-me.md y voice.md. Cuando quieras redactar un número, di "escribe un boletín" y usaré los tres archivos juntos.

[Si es modo arquetipo: Recuerda que este archivo se construyó a partir de valores predeterminados de arquetipo. Después de unos 5 números publicados, vuelve a ejecutar este skill con tus muestras reales para obtener un perfil más preciso.]

Qué produce este skill

Un archivo en la raíz del proyecto:

• newsletter-voice.md: instrucciones de escritura específicas para boletines que cubren audiencia, principios de voz, fórmula de apertura, flujo de secciones, filosofía de datos, formato, cierre, patrones de ausencia y objetivos de longitud

Reglas

• Se requiere voice.md y about-me.md en la raíz del proyecto antes de ejecutar. Detente y redirige a voice-builder si falta alguno.
• Mínimo 2 muestras de boletín si el usuario elige el modo basado en muestras. Ofrece el modo arquetipo si tiene menos.
• Mantén newsletter-voice.md por debajo de 1200 palabras. Lo conciso supera a lo exhaustivo.
• No inventes señales de voz. Trabaja solo a partir de muestras o valores predeterminados de arquetipo ajustados a voice.md.
• No dupliques contenido de voice.md. Refiérelo cuando sea relevante. newsletter-voice.md añade solo reglas específicas para boletines.
• No incluyas nombres específicos, URLs o frases de despedida del usuario a menos que aparezcan de forma consistente en 2 o más muestras.
• No produzcas un archivo de voz o palabras prohibidas por separado. Los patrones de ausencia viven dentro de newsletter-voice.md como una sola sección.
• Usa español neutro en todo momento, a menos que las muestras estén claramente en una variante regional específica.
• Nunca uses guiones largos (em dash) en ningún archivo de salida ni en ningún borrador.