Habilidades de guion: 24 habilidades de agente para escribir cine y televisión
Explora 24 habilidades de agente reutilizables para la escritura de guiones, televisión, dramaturgia, ópera china y análisis de guiones en Claude Code y Codex.
Habilidades de guion: 24 habilidades de agente para escribir cine y televisión
El software de escritura puede generar escenas rápidamente. Es mucho más difícil escribir un guion que mantenga el conflicto, controle la información, respete el formato y resista las revisiones. El repositorio de código abierto jtydhr88/screenwriting-skills aborda esa brecha con una biblioteca estructurada de 24 habilidades de agente para la escritura de guiones, televisión, teatro y dramaturgia.
El proyecto convierte ideas de 45 libros sobre técnica y 23 guiones, partituras y obras de teatro publicados en archivos SKILL.md reutilizables. Estos archivos están diseñados para Claude Code y OpenAI Codex, pero siguen el formato neutral para agentes de openagentskills.io, por lo que cualquier agente compatible puede utilizarlos potencialmente.
¿Qué problema resuelve?
Un modelo de lenguaje de propósito general puede saber que un guion necesita un protagonista, conflicto, escenas y diálogos. Aun así, puede producir conversaciones cargadas de exposición, cierres de acto débiles, motivaciones de personajes incoherentes o episodios televisivos sin un motor narrativo repetible.
Estas habilidades proporcionan un proceso de trabajo más disciplinado. En lugar de pedirle a un agente que “mejore el guion”, un escritor puede invocar una capacidad específica para:
- Encontrar la idea rectora y poner a prueba una premisa
- Construir la estructura de un largometraje o una serie
- Diseñar una red de personajes que genere conflicto
- Reescribir los diálogos como acción, en lugar de simple transmisión de información
- Dividir un episodio en actos y cierres de acto
- Crear una biblia de serie y documentos de presentación
- Adaptar una novela a un drama de varios episodios
- Analizar guiones publicados y tradiciones dramáticas
- Mantener el estado del proyecto a lo largo de varias sesiones de escritura
El resultado se parece más a un asistente de escritura consciente del oficio que a un generador de texto genérico.
Instalación
Instalación desde el marketplace de Claude Code
La instalación recomendada para Claude Code utiliza el marketplace de plugins:
/plugin marketplace add jtydhr88/screenwriting-skills
/plugin install screenwriting@screenwriting-skills
Las habilidades estarán disponibles mediante el espacio de nombres /screenwriting:<skill>. Por ejemplo:
/screenwriting:sw-dialogue
Para ver las habilidades cargadas en el entorno actual, ejecuta:
/skills
Claude Code: instalar para todos los proyectos
git clone https://github.com/jtydhr88/screenwriting-skills.git
cp -r screenwriting-skills/plugins/screenwriting/skills/* ~/.claude/skills/
Claude Code: instalar en un proyecto
mkdir -p .claude/skills
cp -r screenwriting-skills/plugins/screenwriting/skills/* .claude/skills/
Instalación en Codex
Para Codex CLI, la aplicación de escritorio de ChatGPT o una extensión para IDE, añade el marketplace e instala el plugin:
codex plugin marketplace add jtydhr88/screenwriting-skills
Después, elige Plugins → Screenwriting Skills → Install.
Los mismos 24 archivos SKILL.md se distribuyen mediante el directorio compartido skills/ del plugin. No existe una edición de Codex reescrita por separado.
Para una instalación personal de Codex:
git clone https://github.com/jtydhr88/screenwriting-skills.git
cp -r screenwriting-skills/plugins/screenwriting/skills/* ~/.agents/skills/
Para una instalación específica de un proyecto:
mkdir -p .agents/skills
cp -r screenwriting-skills/plugins/screenwriting/skills/* .agents/skills/
Puedes invocar explícitamente una habilidad con un comando como $sw-story-structure, o dejar que el agente detecte automáticamente el contexto relevante.
Una arquitectura de cuatro capas
El repositorio organiza sus habilidades en cuatro capas. Esto es importante porque un guion de largometraje, una serie de streaming, una obra teatral y una ópera china pueden compartir algunos principios dramáticos, pero requieren estructuras y reglas de escritura muy diferentes.
1. Dramaturgia general
La capa independiente del medio cubre los fundamentos utilizados en distintos proyectos:
sw-workflow: orquestación del proyecto, entregables, puntos de control y archivos persistentesstory-bible.mdsw-story-structure: puntos de la trama, paradigmas, beats, complicaciones, crisis, clímax, subtramas, comienzos y finalessw-premise-theme: pruebas de premisa, ideas rectoras, loglines, conflicto temático y núcleo de la historiasw-character-conflict: psicología de personajes, oposición, orquestación y conflicto crecientesw-dialogue: diálogo como acción, subtexto, exposición, vocabulario de los personajes y problemas a nivel de líneasw-scene-craft: giros de valor, análisis de escenas, ritmo, transiciones, utilería y entrar tarde o salir prontosw-format-adaptation: formato de guion, salida en Fountain, convenciones de guion chinas y japonesas, adaptación y revisión
Un flujo de trabajo útil para un largometraje puede pasar de la premisa a la estructura, después a los personajes, las escenas, el borrador, la revisión y la presentación. La habilidad de flujo de trabajo nombra la habilidad pertinente en cada etapa y define comprobaciones de salida orientativas.
2. Escritura específica del medio
La segunda capa añade reglas que los libros generales sobre guion no pueden enseñar por completo:
sw-series-structure: teasers, cold opens, cuadrículas de actos para televisión abierta, pruebas de actos para streaming, cierres de acto, cliffhangers, entrelazado de historias A/B/C, beats del piloto y forma de la temporadasw-series-engine-bible: motores de serie repetibles, redes de personajes, tipos de piloto, minas narrativas y documentos de presentaciónsw-writers-room: desarrollo de historias, responsabilidades del showrunner, funciones del equipo, cadenas de documentos, notas, calendarios y limitaciones de producciónsw-sitcom-comedy: comedia de media hora, mecánicas de los chistes, gags recurrentes, cold opens, remates, multicámara, cámara única, animación y dramediasw-chinese-series-practice: formatos de televisión chinos, suspense episódico, procesos de adaptación, controles de producción, contratos y límites de contenidosw-chinese-opera-banqiang: el sistema vocal banqiang utilizado en tradiciones como la ópera de Pekín, Yu, Yue, Qin, Ping y Husw-chinese-opera-qupai: sistemas de melodías fijas utilizados en formas como el drama Yuan, el chuanqi de las dinastías Ming y Qing, la ópera kunqu y el estilo de tono agudo de la ópera de Sichuan
La capa de series incluye referencias temporales concretas, como marcas de página para televisión abierta alrededor de las páginas 17–18, 30, 45 y 60, además de desgloses de pilotos marcados por minutos. También aborda la diferencia práctica entre una historia que funciona una vez y un motor de serie capaz de generar muchos más episodios.
3. Tradición e industria
La tercera capa sitúa la técnica en un contexto cultural y comercial:
- Estudios de caso de largometrajes estadounidenses
- Métodos japoneses de escritura de guiones
- Enfoques coreanos y franceses de escritura
- Prácticas de producción televisiva china
- Industria, pitching, opciones, créditos, agentes, contexto del WGA y desarrollo orientado a compradores
Esta capa resulta especialmente útil cuando un agente necesita comparar métodos en lugar de presentar una única fórmula supuestamente universal. El repositorio conserva las discrepancias entre las fuentes, como la cuadrícula de cuatro actos de Douglas y el argumento de Oberg de que las rupturas de acto están determinadas principalmente por la presión narrativa y las realidades de producción.
4. Corpus principales
La capa final trata las obras completas como material de trabajo, no solo como ejemplos inspiradores. Incluye:
- Las obras teatrales completas y piezas breves de Chéjov
- Seis guiones de Ozu
- Las cuatro temporadas completas de Succession, que abarcan 39 guiones de rodaje
- Estudios de caso de The West Wing, The Sopranos, Downton Abbey, Fleabag y otras series
La habilidad succession-series-writing, por ejemplo, examina cámaras de presión, episodios contenedores basados en ceremonias, humillación descendente, acotaciones que transmiten subtexto, reversiones activadas por una sola palabra, líneas alternativas y el desafío de construir un final cuando el motor principal pierde presión.
Ejemplos de uso práctico
Un escritor puede utilizar la biblioteca mediante solicitudes en lenguaje natural:
Divide mi serie de 12 episodios en actos y coloca los cierres de acto.
Esto debería dirigir la solicitud hacia sw-series-structure.
Mis diálogos son demasiado obvios. Diagnostica el problema y reescribe la escena.
Esto combina sw-dialogue con sw-scene-craft.
Convierte esta novela de 400.000 palabras en el esquema de un drama chino de 40 episodios.
Esto requiere sw-chinese-series-practice y sw-series-engine-bible, haciendo explícitas las decisiones de adaptación en lugar de comprimir la fuente silenciosamente.
Configura un proyecto y lleva un registro de mi progreso.
Ese es el papel de sw-workflow, que utiliza una convención de story bible para conservar el estado del proyecto entre sesiones.
Por qué el diseño multilingüe utiliza un único árbol de fuentes
Los cuerpos de las habilidades están escritos en chino porque gran parte del material de origen está compuesto por textos chinos originales o traducciones al chino. Sin embargo, el idioma de respuesta del agente sigue la solicitud del escritor. Un escritor puede preguntar en inglés, japonés, coreano o francés y recibir una respuesta en ese idioma.
Esto evita mantener árboles de habilidades traducidos por separado. El proyecto tuvo anteriormente una edición en inglés, pero mantener árboles paralelos crea un problema de sincronización a largo plazo: una vez que existe una traducción, los usuarios pueden solicitar razonablemente versiones en japonés, coreano, francés, ruso y otros idiomas. Cinco árboles lingüísticos implicarían cientos de archivos que podrían divergir de forma independiente.
La terminología se gestiona mediante correspondencias en sw-workflow/terms.md. Conceptos como “logline”, “act out”, “beat sheet”, “showrunner” y “staff writer” permanecen vinculados a sus términos originales de la industria. Los términos sin un equivalente claro pueden conservar la palabra original acompañada de una explicación.
Existe una contrapartida: los lectores que no sepan chino no pueden auditar directamente los archivos de instrucciones subyacentes. Los README traducidos proporcionan información sobre la instalación, la estructura y las políticas, mientras que las tablas completas de habilidades y la bibliografía permanecen en la documentación principal y en chino.
Material de referencia detallado sin archivos de habilidades sobredimensionados
Cada habilidad contiene un SKILL.md con principios, flujos de trabajo y listas de comprobación. Casi todas las habilidades también incluyen un reference.md con tablas, ejemplos, fragmentos y análisis desarrollados.
Algunas áreas más extensas se dividen en varios archivos de referencia. Por ejemplo, los estudios de caso de series separan el material en colecciones de guiones en inglés, desgloses de pilotos y textos asiáticos. La habilidad sobre motores de series separa los análisis de motores, las tablas de campos de documentos y las muestras completadas.
Esta separación mantiene manejables las instrucciones operativas. El repositorio también procura mantener los archivos SKILL.md por debajo de aproximadamente 40 KB y las descripciones de las habilidades por debajo del límite de 1.024 caracteres exigido por las convenciones del proyecto.
Añadir nuevos medios sin debilitar el núcleo
El repositorio utiliza una regla estricta para decidir si un nuevo género merece su propia habilidad: debe cambiar las reglas estructurales, formales o lingüísticas de la escritura. Una categoría temática como thriller de espionaje o drama familiar no reúne automáticamente los requisitos. Esas categorías pertenecen a los estudios de caso, salvo que un corpus completo y distintivo justifique un tratamiento específico.
Un nuevo medio debe añadir:
- Una habilidad nueva
- Una tabla de límites que explique qué métodos generales se transfieren
- Una entrada en la tabla de enrutamiento del flujo de trabajo
Las habilidades generales no deben reescribirse cada vez que se añade un nuevo medio. Esta arquitectura permitió que las capas de series y ópera china se ampliaran sin modificar las habilidades básicas de premisa, estructura, diálogo y escenas.
La ópera china ilustra por qué esta separación es importante. Banqiang y qupai se tratan como dos sistemas porque sus estructuras vocales, métodos líricos y unidades escénicas son diferentes. Las tradiciones regionales dentro de un mismo sistema suelen poder utilizar apéndices de referencia en lugar de habilidades separadas, lo que evita cientos de habilidades casi duplicadas para cada género regional.
Fuentes y licencias
El proyecto se basa en 17 libros sobre técnica de guion, 15 libros sobre escritura televisiva, guiones y obras publicados, además de una amplia teoría, guiones y partituras de ópera china. Entre las fuentes se encuentran obras de Syd Field, Blake Snyder, Robert McKee, Lajos Egri, Lisa Cron, Neil Landau, Pamela Douglas, William Rabkin, Jesse Armstrong, Aaron Sorkin, Phoebe Waller-Bridge, Chéjov, Ozu y muchos escritores y teóricos chinos.
El repositorio está licenciado para uso personal y educativo. Las citas siguen siendo propiedad de sus autores y traductores originales, por lo que conviene tratarlo como una herramienta de aprendizaje y desarrollo, no como sustituto de los textos originales licenciados.
¿Quién debería utilizarlo?
Esta colección resulta especialmente adecuada para:
- Guionistas que desarrollan largometrajes o pilotos
- Guionistas de televisión que construyen una biblia de serie
- Showrunners y participantes de equipos de guionistas
- Investigadores que comparan tradiciones dramáticas
- Desarrolladores que prueban habilidades de agente específicas de un dominio
- Escritores que adaptan novelas, obras de teatro o propiedad intelectual existente
- Docentes que crean ejercicios de escritura estructurados
Es menos adecuada para quienes buscan un prompt de un solo clic del tipo “escríbeme un guion”. Su valor reside en el desarrollo por etapas, las decisiones explícitas de oficio, las alternativas respaldadas por fuentes y la revisión repetida.
Con 1.000 estrellas y 118 forks indicados en GitHub, el repositorio ha despertado un interés considerable como ejemplo de cómo empaquetar conocimientos especializados para agentes de programación. Su idea más importante es arquitectónica: en lugar de pedirle a un modelo general que recuerde todas las reglas de guion a la vez, hay que proporcionarle habilidades pequeñas y combinables que puedan seleccionarse según el problema de escritura actual.