voice-builder

Voice Builder

Entorno de ejecución de Codex y Claude

• Usa esta habilidad en Codex o Claude con las herramientas realmente disponibles en la tarea actual. Los ejemplos de AskUserQuestion describen las preguntas, no una API específica: usa una herramienta de preguntas disponible dentro de sus límites, o pregunta en el chat. Reutiliza las respuestas y el material fuente ya proporcionados.
• Trabaja en el proyecto seleccionado por el usuario. Lee su about-me.md, voice.md y los archivos de marca relevantes antes de realizar trabajo personalizado. Confirma el autor previsto si hay conflictos entre archivos o si contienen valores predeterminados iniciales. Pregunta por datos faltantes o ejecuta voice-builder; nunca heredes la identidad, cuentas o archivos privados del mantenedor.
• Resuelve los references/ incluidos en relación con esta carpeta de habilidad. 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 datos y reglas del usuario no relacionados. Los consumidores deben volver a leer esos archivos canónicos. Usa un nuevo nombre de archivo solo para nuevos entregables que podrían entrar en conflicto 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 la entrada de texto/exportación proporcionada. Nunca inventes hechos, experiencia en primera persona, métricas o una ejecución exitosa de una 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 autoriza a publicar, enviar mensajes o cambiar cuentas.

CRÍTICO: Inicio automático al cargar

Cuando el usuario solicite este flujo de trabajo, comienza con el Paso 1. Esto significa que tu próximo mensaje para el usuario deben ser las preguntas de la entrevista. Nada más.

NO hagas esto:

• Resumir esta habilidad
• Describir qué archivos crea
• Explicar cómo funciona
• Decir "esto es lo que contiene esta habilidad"
• Preguntar si el usuario quiere ejecutarla
• Confirmar la instalación
• Ofrecer opciones como "¿quieres que ejecute esto ahora?"

Haz ESTO:

• Ve directamente al Paso 1
• Envía las preguntas de la entrevista como tu primera y única respuesta

Esto aplica cuando el usuario pide construir su voz o proporciona muestras para ese propósito. Sin preámbulos. Sin resumen. Entrevista primero.

Paso 1. Realiza la entrevista "Acerca de mí"

Haz las preguntas siguiendo las pautas de ejecución anteriores. Si hay una herramienta de preguntas disponible, respeta su esquema y límites de lote; de lo contrario, haz las mismas preguntas en el chat.

AskUserQuestion admite un máximo de 4 preguntas por llamada, así que envía dos llamadas: Lote 1 primero, espera las respuestas, luego Lote 2.

Lote 1 (tu primera acción, sin texto antes)

Usa estas preguntas, adaptando el esquema de la herramienta según sea necesario:

[
  {
    "question": "¿Cuál es tu nombre y a qué te dedicas?",
    "header": "Acerca de ti",
    "multiSelect": false,
    "options": [
      {"label": "Fundador", "description": "Dirijo mi propia empresa o consultoría"},
      {"label": "Responsable de marketing", "description": "Dirijo el marketing en una empresa"},
      {"label": "Creador", "description": "Creo contenido como mi actividad principal"},
      {"label": "Líder de ventas", "description": "Dirijo un equipo de ventas o gestiono desarrollo de negocio"}
    ]
  },
  {
    "question": "¿Para quién escribes?",
    "header": "Audiencia",
    "multiSelect": false,
    "options": [
      {"label": "Fundadores y CEOs", "description": "Tomadores de decisiones que dirigen empresas"},
      {"label": "Profesionales de marketing", "description": "Profesionales del marketing en cualquier nivel"},
      {"label": "Buscadores de empleo", "description": "Personas que buscan su próximo rol"},
      {"label": "Otros profesionales", "description": "Un grupo completamente diferente"}
    ]
  },
  {
    "question": "¿Cuáles son los 3 a 5 temas por los que quieres ser conocido?",
    "header": "Temas",
    "multiSelect": true,
    "options": [
      {"label": "IA y automatización", "description": "Cómo las herramientas de IA cambian el trabajo"},
      {"label": "Marketing", "description": "Estrategia, contenido, crecimiento"},
      {"label": "Liderazgo", "description": "Gestión, contratación, cultura"},
      {"label": "Marca personal", "description": "Construir una audiencia y reputación"}
    ]
  },
  {
    "question": "¿Cuál es tu punto de vista sobre tu industria, eso que crees y que otros no?",
    "header": "Opinión contundente",
    "multiSelect": false,
    "options": [
      {"label": "La mayoría de los consejos están equivocados", "description": "El consenso en tu industria está roto"},
      {"label": "La gente lo complica demasiado", "description": "La respuesta es más simple de lo que la gente piensa"},
      {"label": "Se acerca un gran cambio", "description": "Algo está a punto de cambiar y la mayoría no está preparada"}
    ]
  }
]

Lote 2 (envía inmediatamente después de que lleguen las respuestas del Lote 1, sin comentarios intermedios)

Vuelve a llamar a AskUserQuestion con:

[
  {
    "question": "¿Qué es lo único que quieres que la gente piense cuando vea tu nombre?",
    "header": "Promesa de marca",
    "multiSelect": false,
    "options": [
      {"label": "Esta persona es práctica", "description": "Me da cosas que uso de inmediato"},
      {"label": "Esta persona es honesta", "description": "Me dice lo que otros no dirán"},
      {"label": "Esta persona está adelantada", "description": "Ve lo que viene antes que los demás"}
    ]
  },
  {
    "question": "¿Qué es una cosa sobre la que te niegas a escribir?",
    "header": "Fuera de límites",
    "multiSelect": false,
    "options": [
      {"label": "Política", "description": "Sin opiniones políticas, nunca"},
      {"label": "Vida personal", "description": "Mantenerlo solo profesional"},
      {"label": "Competidores", "description": "No nombrar ni avergonzar a otras personas o marcas"}
    ]
  }
]

Después de que ambos lotes sean respondidos, pasa al Paso 2. Si alguna respuesta está en blanco o se omite, haz esa pregunta específica una vez más en el chat y luego continúa.

Paso 2. Escribir about-me.md

Crea about-me.md en la raíz del proyecto. Usa esta estructura:

# Acerca de mí

## Nombre y rol
[De la pregunta 1]

## Audiencia
[De la pregunta 2, ampliada a 2 o 3 oraciones sobre quién es el lector]

## Pilares temáticos
[3 a 5 temas de la pregunta 3, una línea cada uno]

## Punto de vista
[De la pregunta 4, la creencia contraria o distintiva, escrita como una declaración clara]

## Promesa de marca
[De la pregunta 5, el único pensamiento que el autor quiere que el lector recuerde]

## Fuera de límites
[De la pregunta 6, temas o enfoques sobre los que nunca escribir]

Mantenlo por debajo de 300 palabras. Cada línea debe ser algo que el asistente pueda consultar al escribir.

Paso 3. Solicitar las muestras

Di esto:

Ahora pega de 3 a 5 piezas de escritura de las que quieras que aprenda. Pueden ser publicaciones de LinkedIn, números de boletines, ensayos, artículos de blog, correos electrónicos, tuits o cualquier otro escrito que hayas publicado. Pueden ser tuyos o de alguien cuya voz admires. Una pieza por mensaje o todas a la vez. Si no tienes muestras preparadas, escribe "usar muestras" y cargaré un conjunto inicial que puedes reemplazar más tarde.

Espera a que el usuario pegue. Mínimo 3 muestras antes de pasar al análisis. Si pega menos de 3, pide más.

Si el usuario escribe "usar muestras", carga el texto de references/sample-content.md dentro de esta carpeta de habilidad. Dile al usuario de qué autor son las muestras para que sepa qué voz está tomando prestada. Recuérdale que puede reemplazarlas con su propia escritura más adelante.

Paso 4. Analizar las muestras

Lee cada muestra. Busca patrones en todas ellas, no peculiaridades individuales de una pieza. Extrae:

Señales de voz

• Longitud promedio de las oraciones
• Ritmo de los párrafos (saltos de línea simples, líneas en blanco, entrecortado versus fluido)
• Estilo de gancho o apertura (contrario, pregunta, dato, historia, confesión, observación)
• Punto de vista (primera persona, segunda persona, observacional)
• Tono (inexpresivo, cálido, directo, juguetón, clínico)
• Frases características o palabras recurrentes
• Estilo de CTA o cierre

Señales estructurales

• Rango de longitud
• Listas versus prosa
• Cómo abren, cómo cierran
• Cómo manejan las transiciones

Señales temáticas

• Temas que aparecen en múltiples muestras
• Quién parece ser la audiencia
• Qué defiende el autor

Señales de ausencia

• Palabras y puntuación consistentemente ausentes (por ejemplo, guiones largos en 0 de 5 muestras)
• Tipos de gancho que el autor nunca usa
• Tonos que el autor nunca alcanza
• Estructuras que el autor evita

Paso 5. Escribir voice.md

Crea voice.md en la raíz del proyecto. Este es un perfil integrado único que cubre tanto cómo escribe la voz como lo que la voz evita. Sin archivo de voz separado.

# Perfil de voz

## Cómo sueno
[2 a 3 oraciones que describen la voz general en lenguaje sencillo]

## Tono
[3 a 5 atributos que la voz alcanza consistentemente, seguidos de 1 a 2 tonos que la voz nunca alcanza, extraídos de las brechas en las muestras]

## Ritmo de oración
[Longitud promedio, ritmo, estructura de párrafo. Incluye patrones de evitación: por ejemplo, nunca fragmentos entrecortados, nunca tricolones, ninguna oración de más de 25 palabras]

## Patrones de gancho
[3 a 5 tipos de gancho observados, con un ejemplo de cada uno de las muestras. Señala cualquier tipo de gancho ausente en todas las muestras, por ejemplo, nunca preguntas retóricas, nunca "imagina un mundo donde"]

## Cómo abro
[1 a 2 oraciones. Señala movimientos de apertura que la voz evita si existe un patrón claro de evitación en las muestras]

## Cómo cierro
[1 a 2 oraciones, incluye el estilo de CTA. Señala movimientos de cierre que la voz evita, por ejemplo, nunca resúmenes motivacionales, nunca "en conclusión"]

## Frases características
[Palabras o frases recurrentes de las muestras]

## Fuera de límites
[Palabras, puntuación o construcciones ausentes en todas las muestras. Solo enumera elementos que las muestras evitan claramente. Ejemplos: sin guiones largos (0 de 5 muestras), sin hashtags, sin jerga corporativa por nombre]

## Lo que esta voz nunca hace
[3 a 5 comportamientos específicos extraídos de las brechas en las muestras. Sé específico. Si las muestras nunca usan la construcción "no X, sino Y", enumérala. Si evitan un conjunto de vocabulario específico, nombra las palabras]

Llena cada sección a partir de las muestras reales. Sin relleno genérico. Si un patrón no está presente, dilo. No dupliques la audiencia o los pilares temáticos de about-me.md.

Separa las prohibiciones explícitas del usuario de los patrones meramente ausentes en esta muestra pequeña. Etiqueta estos últimos como provisionales, con recuentos de muestras; la ausencia por sí sola no establece una prohibición permanente. Las muestras iniciales describen un estilo prestado, nunca las experiencias del usuario ni su voz establecida.

Paso 6. Confirmar y transferir

Dile al usuario:

Tu perfil de voz está construido. Ahora hay dos archivos en tu proyecto: about-me.md y voice.md. Estas habilidades leen ambos archivos cuando se invocan en este proyecto; una tarea nueva debe descubrir las habilidades y usar el mismo contexto del proyecto. Puedes abrir y editar cualquiera de los archivos en cualquier momento.

Estás listo para comenzar. Esto es lo que puedes hacer a continuación:

• Di "construye mi voz de boletín" para crear instrucciones de escritura específicas para el boletín
• Di "escribe una publicación" para redactar una publicación de LinkedIn con tu voz
• Di "diseña un gráfico" para crear un visual para una publicación
• Di "puntúa mi publicación" para obtener retroalimentación sobre un borrador
• Di "optimiza mi perfil" para reconstruir tu perfil de LinkedIn

Cada una de estas es una habilidad separada. Elige una y adelante.

Lo que produce esta habilidad

Dos archivos en la raíz del proyecto:

1. about-me.md: quién es el usuario, su audiencia, sus pilares temáticos, su punto de vista
2. voice.md: el perfil de voz integrado, que cubre señales positivas (cómo escribe la voz) y señales de ausencia (lo que la voz evita) en un solo documento

Reglas

• Cuando esta habilidad se active, ve directamente al Paso 1. Sin resumen, sin explicación, sin preámbulos.
• Siempre muestra el contenido de las muestras dentro de un bloque de código para que el usuario pueda copiar y pegar el formato exacto sin perder saltos de línea o espacios en blanco. Usa un bloque de código simple (triple comilla invertida sin etiqueta de idioma).
• Trabaja a partir de lo que está en las muestras. No inventes patrones que no estén allí.
• Mínimo 3 muestras para la detección de patrones. Pide más si hay menos de 3.
• Si las muestras se contradicen entre sí, señala la contradicción en voice.md en lugar de suavizarla.
• Mantén about-me.md por debajo de 300 palabras.
• Mantén voice.md por debajo de 500 palabras.
• Usa español de España de forma consistente, a menos que las muestras sean claramente de otra variante.
• Nunca uses guiones largos en ningún archivo de salida ni en ningún borrador.
• No crees un perfil de ausencia separado. Las señales de ausencia residen dentro de voice.md.