CommunityRedacción y edicióngithub.com

revisión-de-guiones

Abre una página en el navegador local para que un revisor revise un guion línea por línea, comente palabras o líneas, edite directamente y envíe notas al agente, que actualiza el archivo markdown.

¿Qué es revisión-de-guiones?

Esta habilidad permite a un agente de IA (como Claude Code, Cursor o Codex) gestionar un flujo de revisión de guiones mediante una página web local. El agente guarda el guion como archivo markdown, inicia un servidor web y abre la página para que el revisor la vea. El revisor puede comentar líneas o palabras seleccionadas, editar líneas directamente y enviar las notas al agente. El agente aplica los cambios mínimos solicitados y actualiza el archivo. El ciclo se repite hasta que el revisor aprueba el guion. Es compatible con entornos donde se ejecute Python 3.9 o superior, sin necesidad de instalar paquetes adicionales. La habilidad incluye comandos para listar guiones, cambiar estados, y cerrar el servidor, y puede integrarse con Tailscale para acceso desde un teléfono.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kjmagnan1s/reviewing-scripts/tree/main/skills/reviewing-scripts

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

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

Documentación

Revisión de guiones

Cada guion es un archivo markdown. El revisor lo lee en una página local y sus notas vuelven a ti como markdown. Todos los comandos son python3 scripts/script_review.py <comando>, con la ruta relativa a la carpeta de esta habilidad. Se requiere Python 3.9 o superior, sin paquetes que instalar.

El ciclo de revisión

  1. Guarda el guion. Escribe el contenido en un archivo temporal y ejecuta script_review.py new --title "<título>" --body-file <archivo> --status drafted. Imprime el id del guion, la ruta del archivo y la dirección de la página. Pon una frase o latido en cada línea de la lectura, para que cada línea pueda tener su propio comentario.
  2. Inicia la página. Ejecuta script_review.py up, luego script_review.py open <id>. Dale al revisor la dirección.
  3. Espera las notas. Ejecuta script_review.py wait <id> en segundo plano. Imprime las notas cuando el revisor haga clic en Enviar notas y sale con código 2 después de dos horas sin envío.
  4. Aplica las notas. Edita el archivo del guion con el cambio más pequeño que responda a cada nota. La página abierta se recarga sola y marca las líneas que cambiaron.
  5. Repite desde el paso 3 hasta que las notas digan "Looks good." Ese envío también mueve un borrador al estado aprobado.

Si no estabas esperando cuando se enviaron las notas, script_review.py inbox imprime cada conjunto no leído.

Reglas para revisar

  • Mantén las ediciones del revisor palabra por palabra. Las líneas listadas bajo "edits (already saved to the file)" son sus propias palabras y ya están en el archivo antes de que veas las notas. Cámbiala solo cuando una nota te lo pida.
  • Cambia solo lo que cubre una nota. No reescribas líneas que no tengan comentario.
  • Aplica "Edits that didn't land" manualmente. La línea se movió antes del envío, así que el archivo no se modificó.
  • Deja las claves del frontmatter que no estableciste. Cambia el estado con script_review.py status <id> <estado>, no editando el archivo.
  • No borres un archivo de guion a menos que el revisor lo pida.

El formato del archivo

---
type: script
id: 2026-01-15-three-prompt-habits
title: Three prompt habits
status: drafted
---

## Spoken Script

Your first line, one sentence per line.
The second line.

## Alternate hooks

Hook 2 (question): A second opening line to film.

## Caption

Anything else you keep with the script.

Copy read en la página copia la sección Spoken Script como un párrafo, luego cada gancho alternativo desde hook 2 hacia arriba como "Two. <línea>". Un archivo sin sección Spoken Script se lee completo. script_review.py read <id> imprime el mismo texto.

Otros comandos

  • list [--status <estado>] [--json]: cada guion con su estado y recuento de palabras.
  • status <id> <estado>: establece un estado (idea, drafted, ready, filmed, posted por defecto).
  • config: la configuración en uso y la ruta del archivo de configuración.
  • down: detiene el servidor de la página.

La configuración (carpetas, puerto, nombres de secciones, estados, nombre del revisor) y el acceso desde el teléfono mediante Tailscale se describen en el README en la raíz del repositorio.

Skills relacionados