🌱 Empieza aquí · Formateador de guiones para leer en voz alta

Esta semilla le enseña a tu asistente a reformatear guiones de video para que puedas leerlos en voz alta sin trabarte. Si grabas videos hablándole a la cámara (Reels, TikTok, Shorts, un podcast o entrevistas) y a la hora de grabar el guión te confunde —párrafos muy densos, no sabes dónde termina una toma, notas de producción metidas entre el texto—, este skill (habilidad) lo deja limpio y lineal: una idea por línea, tomas numeradas, pausas naturales, y todas las notas de producción movidas a un anexo al final.

Para instalarla

Abre esta carpeta con Claude Code o Cowork y dile a tu asistente:

"Siembra esta semilla 🌱"

Con eso basta de tu parte. Tu asistente hace todo lo demás y al final te dice cómo comprobar que quedó funcionando. Vas a ver algunas palabras en inglés en la pantalla; ni caso, él te guía.

¿Otras formas de pedírselo? "instala esta semilla", "pon a funcionar el formateador de guiones", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Este componente es un skill (una habilidad): un método de formato escrito en un solo archivo SKILL.md. No es un hook (gancho de automatización): no lleva chmod, no lleva entrada en settings.json y no ejecuta ningún script. Se "siembra" colocando el archivo donde tu plataforma carga sus habilidades, para que se active solo cuando alguien pida reformatear un guión para leer en voz alta.

1. Copia el skill a la carpeta de habilidades

El kernel trae un solo archivo: kernel/SKILL.md (el método de formato completo, con su disparador en el frontmatter).

Claude Code (macOS / Linux / Windows con Git Bash):

mkdir -p "$HOME/.claude/skills/script-readaloud-formatter"
cp kernel/SKILL.md "$HOME/.claude/skills/script-readaloud-formatter/SKILL.md"

Windows (PowerShell):

New-Item -ItemType Directory -Force -Path "$HOME\.claude\skills\script-readaloud-formatter" | Out-Null
Copy-Item kernel\SKILL.md "$HOME\.claude\skills\script-readaloud-formatter\SKILL.md"

Los skills dentro de ~/.claude/skills/ se descubren solos: el asistente lee su description y lo activa cuando el pedido encaja.

Cowork: usa la misma carpeta de habilidades si tu proyecto la soporta (.claude/skills/script-readaloud-formatter/SKILL.md). Si no, coloca SKILL.md dentro del proyecto y agrega una línea en el archivo de instrucciones del proyecto (el CLAUDE.md) que apunte a él, por ejemplo: "Cuando te pidan reformatear un guión para leer en voz alta, aplica el método de SKILL.md."

Codex: Codex lee su archivo de instrucciones AGENTS.md. Copia el contenido de SKILL.md dentro de AGENTS.md (o guárdalo aparte en el proyecto y agrégale un puntero), para que el método se cargue con el resto de tus instrucciones y lo apliques cuando te lo pidan.

2. Aterrizar el contexto opcional (si aplica)

Este skill no necesita ningún dato obligatorio para funcionar. Es opcional: si la persona tiene un mapa de series o pilares de contenido, un tope de duración por plataforma o una guía de voz de su marca, puede tenerlos a la mano al usar el skill para que el formato respete esos límites. Si no los tiene, no pasa nada: el motor de formato trabaja solo con el guión.

3. Verificación post-siembra (obligatoria)

Como es un método (texto), la verificación tiene dos partes: que el archivo quedó en su lugar, y que el skill de verdad reformatea.

a) El archivo quedó colocado (ejemplo Claude Code):

ls -la "$HOME/.claude/skills/script-readaloud-formatter/SKILL.md"; echo "exit=$?"

Salida esperada: una línea que lista el archivo (con su tamaño) y exit=0. Si sale No such file or directory, la copia no se hizo; repite el paso 1.

b) El skill reformatea de verdad (prueba de comportamiento, en una conversación nueva): en una sesión nueva, pégale al asistente un guión denso de prueba —un párrafo largo de varias frases seguidas, con alguna nota de producción metida en medio— y dile: "reformatea este guión para leerlo en voz alta". La conducta correcta es que devuelva el texto en una sola columna lineal, con las tomas numeradas (**1**, **2**…), una idea por línea con espacio entre ideas, las pausas marcadas con …, y la nota de producción movida a una sección de ANEXOS al final en vez de dejarla entre el texto. Si en cambio te devuelve el mismo párrafo denso sin cambios, el skill no se cargó: revisa que SKILL.md esté en la carpeta de habilidades (o dentro de AGENTS.md en Codex).

Cuando ambas partes pasen, avísale a la persona en una línea qué gana con esto.

✅ ¿Cómo sé que funcionó?

De ahora en adelante, cuando le pases a tu asistente un guión y le pidas dejarlo listo para grabar, te lo va a devolver limpio y lineal: una idea por línea, tomas numeradas, pausas naturales marcadas, y todas las notas de producción apartadas en un anexo al final. A la hora de grabar leyendo, vas a fluir sin trabarte ni perderte. Eso es todo. 🌱