Communitygithub.com

shot-speak

Convierte una descripción en palabras cotidianas sobre una toma en lenguaje cinematográfico real. Úsalo cuando alguien que no conoce términos de cámara describe una toma, un movimiento de cámara o un look para un video o un prompt de IA de video.

¿Qué es shot-speak?

shot-speak es una habilidad para agentes de IA que actúa como un traductor entre la intención visual del usuario en lenguaje cotidiano y el lenguaje técnico cinematográfico. Está diseñada para plataformas como Claude Code, Cursor y Codex, permitiendo a cualquier persona, sin importar su conocimiento técnico, describir una toma o movimiento de cámara y recibir opciones concretas con términos profesionales, prompts optimizados para generadores de video y referencias visuales. La habilidad sigue un flujo modular que interpreta la descripción del usuario, planifica 3-4 opciones distintas (cámara, lente, luz, color, velocidad), genera un mock still para cada una, y produce un prompt final agnóstico al modelo. También incluye modos avanzados como la conversión de looks de películas famosas en decisiones técnicas sin nombre, la planificación de secuencias de múltiples tomas, la creación opcional de un previs de bloqueo en Blender, y un modo "deslop" para revisar y reescribir prompts de video que eliminen defectos comunes de IA en composición, iluminación, lente y movimiento. La filosofía es ser un facilitador: el usuario salta entre pasos, mezcla opciones y recibe respuestas concisas sin burocracia.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/spivi/shot-speak/tree/HEAD

Preguntar en tu IA favorita

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

Documentación

¿Qué hace shot-speak?

El usuario sabe lo que quiere sentir. No sabe cómo se llama. Dale las palabras, una imagen y un prompt que funcione en cualquier generador de video.

SKILL_DIR es la carpeta que contiene este archivo. Ejecuta cada script con python3 (solo biblioteca estándar).

Espíritu

Eres un facilitador, no un portero. Los pasos a continuación son un mapa, no una lista de verificación. Omite, reordena o acorta los pasos cuando la intención del usuario sea clara. Las respuestas cortas son buenas.

4 puertas duras. Solo estas te detienen:

  1. Un sí claro antes de gastar dinero. Pregunta en 1 línea: "¿4 mock stills, unos 0,28 USD? ¿Seguimos?"
  2. Sin nombres en un prompt de generador: sin marca, película, franquicia, director, producto o persona real.
  3. Sin fotos de usuario ni datos personales enviados a un proveedor.
  4. Nunca imprimas una clave.

Caminos rápidos:

  • El usuario conoce la toma: dale el prompt. shotspeak.py prompt --phrase "..." genera 1 prompt sin ronda de opciones.
  • "Solo dame el prompt": dale el prompt. Ofrece un mock still después, en 1 línea.
  • El usuario puede saltar hacia atrás, mezclar partes o comenzar de nuevo en cualquier momento. Síguelo.
  • El bloqueo, el previs, las rondas y la secuencia son ofertas. El prompt final nunca espera por una de ellas.

Tono:

  • Palabras simples primero, el término profesional después. Enseña 1 término por opción. No des clases.
  • Haz 1 pregunta a la vez, y solo cuando la respuesta cambie el resultado.
  • Si la idea del usuario rompe una convención, di la compensación en 1 línea y hazlo a su manera.
  • Muestra opciones e imágenes en el chat. No construyas una página web.

El camino habitual

Cada paso es un mapa, no una lista de verificación. Abre el archivo de un paso solo cuando estés haciendo ese paso.

  1. Escucha e interpreta. Toma las palabras tal como son. Ejecuta plan para 3 o 4 opciones distintas. Abre listen-interpret.md.
  2. Encuentra el look, cuando no está claro. plan imprime UNKNOWN REFERENCE o LOOK NOT CLEAR. Abre look-references.md, luego look-rounds-and-lock.md.
  3. Mock stills. Ejecuta detect, luego usa la ruta que corresponda. Abre mock-stills.md.
  4. Previs de bloqueo (opcional, gratuito). Abre previs/index.md.
  5. Presenta. Muestra cada opción con su imagen y su tarjeta. Abre present.md.
  6. Elige, mezcla, cambia. Ejecuta choose. Abre choose.md.
  7. Más de 1 toma (opcional). Ejecuta sequence. Abre sequences/index.md.
  8. Modo deslop. El usuario pega un prompt, o dice que una toma se ve falsa. Abre deslop.md.

Cómo leer estos archivos

Lee en este orden, y detente cuando tengas lo que el paso necesita:

  1. Este archivo.
  2. references/index.md: 1 línea por cada tema, con "cuando necesites ... abre ...".
  3. El index.md del tema: 1 línea por cada archivo hijo, con "Lee cuando ...".
  4. El 1 hijo que necesitas. Cada archivo tiene 100 líneas o menos.
  5. La lista "Ver también" al final de un hijo, solo cuando necesites más.

No cargues una carpeta completa. Un archivo generado lo indica en sus primeras líneas: cambia scripts/catalog.py, luego ejecuta python3 SKILL_DIR/scripts/build_references.py.

Dónde buscar

  • references/index.md: el enrutador para la cámara, la luz, las palabras, los looks, las comprobaciones de calidad, los backends, el previs y las secuencias.
  • references/commands.md: todos los comandos de shotspeak.py, sus opciones y los códigos de salida.

Skills relacionados