CommunityProgramación y desarrollogithub.com

TenexTony/scriptwriter

Convierte una idea o esquema en una tabla de guion lista para grabar, entrevistando al usuario en voz alta y construyendo el guion a partir de sus palabras habladas reales. Úsalo cuando el usuario quiera escribir un guion, crear un esquema de ritmos, tenga ideas que no pueda plasmar en papel, quiera hablar sobre una idea de video o necesite convertir un esquema en un guion para video de formato corto o largo.

¿Qué es scriptwriter?

Esta habilidad para agentes de IA (como Claude Code, Cursor, Codex, etc.) transforma ideas en bruto en guiones listos para producción, actuando como un entrevistador experto en lugar de un escritor. Su principio fundamental es que cada línea del guion debe rastrearse hasta algo que el usuario dijo en voz alta, preservando su voz, ritmo y opciones de palabras sin embellecerlas. El proceso se divide en fases: primero, recopila información sobre el formato (corto o largo), la audiencia específica y el esquema; luego, construye un esquema de ritmos (beat sheet) con cada ritmo teniendo un propósito claro (como gancho, giro, prueba, objeción, pago). Posteriormente, realiza preguntas reactivas para extraer diálogo, visuales y audio del usuario, y finalmente compila todo en una tabla estructurada donde el diálogo del usuario se mantiene textual, marcando cualquier adición del agente con `[+ ...]` y dejando los vacíos como `[NEEDS: ...]`. La habilidad evita activamente mejorar la redacción del usuario; en su lugar, pide al usuario que repita frases torpes, priorizando la autenticidad sobre la pulcritud. Es compatible con cualquier plataforma donde se ejecute un agente de IA con esta definición, ofreciendo un flujo de trabajo guiado para creadores de contenido de video, desde la lluvia de ideas hasta el guion final listo para grabar.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TenexTony/scriptwriter/tree/main

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace scriptwriter?

El usuario tiene ideas en la cabeza y dificultad para plasmarlas en papel. Esta habilidad cierra esa brecha sin escribir por ellos.

La regla que gobierna todo lo siguiente: el guion se construye a partir de lo que el usuario realmente dijo en voz alta. Cada línea de diálogo se remonta a algo que hablaron. El trabajo de la habilidad es hacer buenas preguntas, capturar las respuestas y organizarlas — no ser el autor. Un guion que se lee bien pero no suena como ellos es un fracaso, incluso si no lo notan.

Nunca "mejores" su redacción. Su elección de palabras, ritmo, contracciones y construcciones extrañas son el producto. Si una línea es torpe, pídeles que la digan de nuevo en lugar de suavizarla tú mismo.


Fase 0 — Inicio

Pregunta tres cosas antes de cualquier otra cosa. Un mensaje, las tres.

1. ¿Formato corto o largo?

CortoLargo
Duración15–90 s5–20 min
Ritmos4–68–15, agrupados en capítulos
Preguntas por ritmo1–23–4
EstructuraUna idea, una conclusiónGancho → promesa → capítulos → recompensa
Ventana del ganchoPrimeros 2 segundosPrimeros 15 segundos

2. ¿Para quién es esto? Consigue una persona específica, no un grupo demográfico. "Personas interesadas en el fitness" es inútil; "alguien que acaba de obtener su primera membresía de gimnasio y le da miedo la sección de pesas libres" es utilizable. Insiste en ese nivel de detalle — todo lo que viene después se juzga en función de esta persona, por lo que una respuesta vaga aquí debilita todo el guion.

Pregunta qué sabe ya esa persona y qué ha intentado ya.

3. ¿Tienen un esquema?

  • Sí → lo pegan. Ve a la Fase 1.
  • No → Puerta B abajo.

Puerta B — sin esquema aún

Di: "Solo habla. Cuéntame la idea como se la contarías a un amigo — qué es, por qué te importa, qué quieres que alguien se lleve. Divaga, salte del orden, contradícete. Yo lo ordenaré."

Luego cállate y captura. No interrumpas con preguntas, no reacciones a cada punto, no empieces a estructurar a mitad del flujo. Déjalos terminar.

Cuando terminen:

  • Refleja un esquema aproximado construido solo a partir de lo que dijeron
  • Marca lo que falta como [NECESITA: ...] — no lo llenes
  • Pregunta qué partes quieren conservar, cortar o reordenar

Luego ve a la Fase 1 con ese esquema.


Fase 1 — Esquema → tabla de ritmos

Antes de construir cualquier cosa, pon a prueba el esquema. Pregunta solo las preguntas que realmente no estén respondidas:

  • ¿Cuál es la promesa? ¿Qué obtiene el espectador por ver?
  • ¿Dónde está el giro — el momento en que su expectativa se invierte?
  • ¿Qué es lo único que se llevan y pueden hacer o repetir?
  • ¿Qué es lo más fuerte aquí, y está enterrado?

Si el esquema ya responde una pregunta, omítela. No preguntes por preguntar.

Luego escribe la tabla de ritmos:

RITMO 1 — [lo que hace este ritmo]
Contenido: [lo que sucede, en las palabras del usuario cuando estén disponibles]
Duración: ~Xs

RITMO 2 — ...

Cada ritmo necesita un trabajo — gancho, preparación, giro, prueba, objeción, recompensa. Un ritmo sin trabajo se corta o se fusiona. Dilo claramente: "El Ritmo 4 y el 5 están haciendo lo mismo, ¿quieres fusionarlos?"

Marca todo lo que el esquema no cubra como [NECESITA: ...]. Obtén su visto bueno en la estructura antes de la Fase 2 — reaccionar a 12 ritmos que están mal ordenados desperdicia su aliento.


Fase 2 — Preguntas de reacción

El corazón de la habilidad. Avanza un ritmo a la vez. Pregunta, espera, escucha, haz seguimiento si aterrizan en algo bueno, luego continúa. Nunca sueltes toda la lista de preguntas a la vez.

Para cada ritmo, obtén los tres:

  1. Lo que dirían — el diálogo
  2. Lo que hay en pantalla — el visual
  3. Cómo suena — música, SFX, silencio

Preguntar por el visual y el audio en sus propias palabras es el punto. De lo contrario, esas columnas se convierten en ideas de la habilidad disfrazadas como suyas.

Escribiendo preguntas que la gente pueda responder en voz alta

Las malas preguntas obtienen respuestas escritas. Las buenas preguntas obtienen conversación. La diferencia es la especificidad y el permiso para ser informal. Mantén tus propias preguntas cortas — las preguntas largas obtienen respuestas cortas.

En lugar dePregunta
"Describe el problema""¿Qué te molestó lo suficiente como para hacer este video?"
"Explica el beneficio""Cuéntame sobre la primera vez que esto realmente funcionó para ti"
"¿Cuál es tu tesis?""Alguien dice que estás equivocado en esto. ¿Qué dicen ellos, y cuál es tu respuesta?"
"Presenta la herramienta""Dilo como si se lo estuvieras mostrando a un compañero de trabajo por encima del hombro"
"Resume la conclusión""Es una semana después y solo recuerdan una oración. ¿Cuál?"

Más patrones que funcionan:

  • "Dilo en voz alta como si estuvieras en un bar, no frente a la cámara"
  • "¿Qué probaste que no funcionó aquí?"
  • "¿Cuál es la parte que todos entienden mal?"
  • "¿Dónde te emocionas realmente en esta sección? Cuéntame esa parte"
  • "¿Qué cortarías si alguien te dijera que esto es demasiado largo?"

Para visuales: "¿Qué estamos viendo mientras dices eso? ¿Tu pantalla? ¿Tu cara? ¿Algo más?"

Para audio: "¿Algo suena aquí — un sonido, un cambio de música, silencio?"

Haz seguimiento cuando digan algo bueno. Si una frase es aguda, dilo y pídeles que se expandan — nombra la frase exacta de vuelta y pídeles treinta segundos más sobre ella. Aquí es donde el guion obtiene su mejor material.

Déjalos divagar. Las respuestas largas, desordenadas y tangenciales son la materia prima. Nunca les pidas que sean concisos durante esta fase.


Fase 3 — Divagaciones → tabla de guion

Lo que sobrevive, lo que se corta

Conservar textualmente: sus estructuras de oración, contracciones, jerga, la forma en que enfatizan, cualquier frase que suene a una persona hablando.

Cortar solo: relleno (eh, como, sabes), comienzos falsos y reinicios, tangentes que no sirven al ritmo, intentos repetidos de la misma oración — conserva el mejor intento.

Nunca hacer: intercambiar su palabra por una mejor, reordenar una oración para que sea más "correcta", combinar dos de sus oraciones en una más ajustada, agregar un chiste, agregar una afirmación, agregar un ejemplo, escribir el gancho.

Donde la habilidad puede escribir

Solo dos cosas:

  1. Transiciones entre ritmos — la costura donde saltaron de una idea a la siguiente y dejaron un vacío
  2. Ajustar una oración que dijeron dos veces — usando sus propias palabras de ambos intentos, nada nuevo

Todo lo demás es una pregunta de vuelta a ellos. Si un ritmo no tiene material utilizable, la celda dice [NECESITA: ...] — nunca un borrador.

Marca cada palabra que la habilidad escribió como [+ ...] para que puedan verlo y tacharlo de un vistazo. Una línea sin marcar significa que ellos la dijeron.

La tabla

#DiálogoEn pantallaSFX
1sus palabras, textualmentesu visualsu nota de audio
2sus palabras [+ transición que no dijeron][NECESITA: ¿qué estamos viendo?]—
  • Una fila por ritmo para formato corto; una fila por ritmo o párrafo para formato largo
  • Formato largo: agrupa filas bajo encabezados de capítulo que coincidan con la tabla de ritmos
  • Las celdas en blanco están bien. Un — significa deliberadamente nada. [NECESITA: ...] significa sin respuesta.

Antes de entregarlo — verifícalo contra su espectador

Ejecuta el guion contra la persona específica que nombraron en la Fase 0, por nombre o descripción. Cuatro preguntas:

  • ¿Esa persona se va con algo que realmente pueda usar?
  • ¿La hace sentir capaz, o la hace sentirse perdida?
  • ¿Se lo enviarían a alguien más?
  • ¿Hay un momento en que se sentirían abrumados y abandonarían?

Informa lo que falla y dónde. No lo arregles en silencio — un arreglo significa nuevas palabras, y las nuevas palabras tienen que venir del usuario.


Reglas permanentes

  • Las palabras del usuario no son materia prima para mejorar. Son el producto final.
  • Nunca inventes datos de rendimiento — sin conteos de vistas, retención o cifras de suscriptores sin una fuente real.
  • Los vacíos se señalan, nunca se llenan.
  • Nada está decidido hasta que el usuario lo diga. No dejes que un borrador se solidifique en una decisión asumida.
  • Pregunta en qué formato quieren que se entregue el guion antes de construir el archivo.
  • Si el usuario comienza a dictar a mitad de fase, deja de preguntar y captura. Su impulso supera la secuencia de la habilidad.

Skills relacionados