Communitygithub.com

viralprinter

Crea videos cortos estructurados de principio a fin. Convierte un tema, producto o URL de video corto en un paquete de grabación basado en evidencia, compone una línea de tiempo declarativa en mp4 con ffmpeg, y califica cualquier video corto — incluyendo la salida de cualquier generador de video con IA — contra reglas de estructura viral. El agente razona y compone; la evidencia se suministra, nunca se inventa.

¿Qué es viralprinter?

viralprinter es una habilidad experta para agentes de IA (compatible con Claude Code, Cursor, Codex y cualquier cliente MCP) que transforma cualquier tema, producto o URL de video corto en un paquete de producción completo con evidencia de estructura viral real. Se compone de dos partes: una CLI local (con comandos validate, compose y grade) que nunca requiere cuenta ni subida de archivos, y un puerto MCP opcional llamado Shorti que proporciona análisis de videos cortos reales — qué clips funcionaron, qué mutó, qué murió, y fórmulas de préstamo (keep / change / never_touch) con recibos de audiencia. La habilidad sigue flujos definidos (A-G) según lo que el usuario pida: desde crear un video sobre un tema hasta calificar un archivo existente. No es un generador de video; el agente razona y compone la línea de tiempo, y Shorti solo suministra evidencia o se abstiene honestamente. El resultado final es un archivo mp4 renderizado con ffmpeg y una calificación estructural detallada. Es ideal para creadores de contenido, equipos de marketing y desarrolladores que quieren producir videos cortos con fundamento en datos reales, no suposiciones.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ds4psb-ai/viralprinter/tree/main

Preguntar en tu IA favorita

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

Documentación

viralprinter — compón y califica videos cortos con evidencia estructural

Estás manejando dos mitades.

  • Local, siempre disponible. La CLI viralprinter en este repositorio: validate, compose (línea de tiempo JSON → mp4 vía ffmpeg) y grade (puntúa cualquier video corto contra reglas de estructura viral). Sin cuenta, sin claves, sin subidas.
  • Evidencia, opcional. La puerta MCP de solo lectura de Shorti: clips reales de video corto analizados, su linaje (qué se movió, qué mutó, qué murió), y fórmulas de préstamo por clip (keep / change / never_touch) con recibos de audiencia.

Shorti no es un generador de video y no debes presentarlo como tal. Tú haces el razonamiento y la composición. Shorti suministra evidencia y se abstiene honestamente cuando la evidencia es escasa — transmite sus abstenciones; nunca las rellenes.

Si el usuario solo quiere que se califique un video corto, salta la mitad de evidencia por completo: Flujo G.

Configuración

La herramienta (requerida para compose y grade)

git clone https://github.com/ds4psb-ai/viralprinter && cd viralprinter
uv pip install -e .          # o: pip install -e .

Python ≥ 3.11. ffmpeg y ffprobe deben estar en PATH — compose y la calificación en modo video los utilizan externamente. Confirma con viralprinter --help antes de prometer un archivo renderizado. Si falta el comando o los binarios, dilo y detente en lugar de describir una salida que no produjiste.

Evidencia de Shorti (opcional)

claude mcp add --transport http shorti https://api.shorti.ai/mcp/public-read/mcp

Cualquier cliente de agente compatible con MCP acepta esa URL de la misma manera. La primera llamada activa OAuth en el navegador — dile al usuario que la complete, luego reintenta una vez. Esta habilidad nunca recopila claves de API, nunca pide al usuario que pegue secretos en el chat, y nunca sube el contenido del usuario: el montaje es de solo lectura por contrato (nunca publica, edita, sube, elimina ni gasta). La calificación y composición no necesitan una cuenta de Shorti; los paquetes de evidencia son la parte que sí la necesita.

Reglas de operación

  1. Una pregunta combinada, como máximo. Si faltan entradas (tema vs producto vs URL, aspecto objetivo, idioma), pregunta una vez, todo junto. Nunca pidas confirmación entre llamadas a herramientas.
  2. Configuración regional. Pasa locale coincidiendo con el idioma del usuario (en, ko, ja) en cada llamada que lo acepte, y responde completamente en el idioma del usuario.
  3. Números. observed_metrics en los resultados de evidencia son recuentos reales del corpus — cítalos como prueba. Los números del calificador son mediciones del archivo que tienes delante — cítalos como mediciones. Nunca produzcas números predictivos: sin contadores de vistas previstos, sin multiplicadores "N×", sin porcentajes de ROI. Afirmaciones sobre estructura, no promesas de resultados.
  4. Ausencia honesta. Evidencia escasa o absteniéndose es la herramienta funcionando correctamente, y también lo es una categoría del calificador que reporta state: not_measured con una razón. Reporta la abstención tal cual; nunca adivines un sustituto o una puntuación.
  5. No pegues JSON en bruto. Sintetiza. El usuario lee prosa, el archivo del paquete y la hoja de puntuación — no cargas útiles.
  6. Disciplina de reintento. Un reintento por llamada fallida. Si un parámetro es rechazado, vuelve a leer la descripción de la herramienta en lugar de adivinar de nuevo.
  7. Nunca inventes contenido. Una línea de tiempo solo puede referenciar archivos que existan en disco. Si faltan clips, di cuáles y detente en el paquete.

Flujo A — "hazme un video corto sobre TEMA" / "이거로 쇼츠 만들어줘"

  1. search_trend_genealogy con el tema. Las solicitudes con límite de tiempo pasan moved_within_days (7 para "esta semana", 30 para "estos días").
  2. Elige la coincidencia más fuerte (indica tu elección y por qué en una oración — no preguntes a menos que sea genuinamente ambiguo).
  3. get_trend_genealogy_card exactamente una vez en esa coincidencia — esta es la fórmula de préstamo: keep / change / never_touch, linaje, prueba de audiencia.
  4. get_clone_kit_capsule para el clip seleccionado — el 콘티 (storyboard) plano por plano.
  5. Compila el paquete (abajo), luego continúa al Flujo F si el usuario tiene material o quiere una renderización.

Flujo B — "haz un video corto para MI PRODUCTO"

  1. suggest_trends_for_product — product_description= funciona sin ningún registro; usa las propias palabras del usuario para el producto.
  2. Luego pasos 2–5 del Flujo A. Si el usuario tiene una cuenta de Shorti con productos registrados, list_my_products + get_my_product_truth afinan la coincidencia.

Flujo C — el usuario pegó una URL de video corto

Una URL pegada nunca es una búsqueda. Llama a preview_pasted_url PRIMERO, luego continúa con los pasos 3–5 del Flujo A sobre lo que resuelve.

Flujo D — entrenamiento durante la grabación

  • Siguiente plano: get_next_shot_cue — una señal por llamada, graba, repite.
  • "¿Cómo lo hice?": get_shot_coaching_rubric, luego tú calificas el clip que el usuario te muestra contra esa rúbrica. La llamada a la rúbrica no lleva ningún parámetro de archivo o URL por diseño — la comprensión del clip es tuya, sobre el contenido que ya ves. Nunca envíes el material del usuario a ninguna parte. Para una segunda opinión estructural sobre un archivo terminado, ejecuta el Flujo G junto a él.

Flujo E — "¿qué hay de nuevo esta semana?"

get_lifecycle_briefing una vez; get_started es la orientación de primer contacto cuando el usuario pregunta qué puede hacer Shorti en general.

El paquete — tu primer entregable

Escribe un archivo local shorti-packet-<slug>.md en el directorio de trabajo:

# <título de trabajo>

## Fórmula (tomada de <referencia de linaje>)
keep / change / never_touch — textualmente de la tarjeta de genealogía, con recibos.

## Lista de planos
Planos numerados del kit de clonación: tiempo, duración, encuadre, acción, señal de audio.

## Señales por plano
Las señales que darías una a una en el set (orden del Flujo D).

## Rúbrica de calificación
La rúbrica con la que calificarás el material del día.

## Evidencia
Referencias de linaje y observed_metrics — solo hechos, sin pronósticos.

Termina ese paso con exactamente una línea legible por máquina:

PACKET_FILE=<ruta absoluta>

Flujo F — paquete → línea de tiempo → mp4 (cierra el ciclo)

El paquete es un plan; esto lo convierte en un archivo. No empieces sin contenido.

  1. Localiza el contenido. Pregunta al usuario una vez por el directorio de clips, o usa las salidas del proveedor ya en disco. Cada src que escribas debe resolverse.

  2. Redacta la línea de tiempo tú mismo. Traduce la lista de planos del paquete en un archivo JSON — lo escribes tú, ninguna herramienta lo genera. Campos, y solo estos:

    {
      "version": "0.1",
      "canvas": {"aspect": "9:16", "resolution": [1080, 1920], "fps": 30},
      "audio": {"music": {"src": "assets/music.mp3", "gain_db": -18}},
      "beats": [
        {
          "id": "hook",
          "role": "hook",
          "t": [0.0, 1.2],
          "shot": {"src": "clips/01.mp4", "in": 3.4, "framing": "close"},
          "text": {"content": "espera", "pos": "center"},
          "cue": "apertura en frío en la revelación, sin logo"
        }
      ],
      "subtitles": {"mode": "none"},
      "provenance": {"packet": "shorti-packet-<slug>.md"}
    }
    

    beats[].t son segundos absolutos, ordenados, sin superposición. role es uno de hook | development | payoff | cta | other. Requerido: version, canvas, beats, y por beat t + shot. Todo lo demás es opcional — omite lo que no sepas en lugar de inventarlo. Lleva el nombre del paquete en provenance. Ejemplos funcionales: examples/*.json.

  3. viralprinter validate <timeline.json> — corrige cada error en la línea de tiempo. Nunca trabajes alrededor de un error de validación; te está diciendo que el plan no es renderizable.

  4. viralprinter compose <timeline.json> -o out.mp4 — usa --dry-run primero si la renderización es larga o el contenido no te es familiar.

  5. Reporta lo que construiste en prosa, luego exactamente una línea legible por máquina:

    VIDEO_FILE=<ruta absoluta>
    
  6. Ofrece la calificación, o ejecútala directamente si el usuario pidió un video corto terminado: viralprinter grade out.mp4 --markdown, luego las reglas de reporte del Flujo G.

Flujo G — "califica este video corto" (no se necesita cuenta de Shorti)

Funciona en cualquier archivo que el usuario señale, incluyendo la salida en bruto de cualquier generador de video con IA, y en una línea de tiempo JSON antes de que se renderice un solo fotograma.

  1. viralprinter grade <file.mp4 | timeline.json> --markdown (--json cuando lo consume una máquina).
  2. Reporta la tarjeta. No hay una puntuación general — la tarjeta es el resultado. No la promedies, no inventes una nota, no clasifiques el video.
  3. Lee las filas not_measured en voz alta con su razón. Un video no puede exponer sus propios roles de beat, por lo que algunas categorías solo son medibles en modo línea de tiempo; esa brecha es la respuesta honesta, no un fallo.
  4. Di qué son las bandas: gruesa, destilada, provenance: provisional. Describen estructura que recurrió en clips analizados. No prometen rendimiento, y una fila out_of_band es una pregunta a responder, no un defecto.
  5. Luego sé útil — nombra el cambio estructural único con el mayor efecto y, si el usuario quiere aplicarlo, ve al Flujo F.

Protocolo de fallo

  • OAuth no completado → una oración diciéndole al usuario que termine el flujo del navegador, luego reintenta una vez.
  • Se llamó a una herramienta que espera una referencia sin ella (falta trend_ref, etc.) → te saltaste un paso; retrocede una llamada en el flujo en lugar de reintentar a ciegas.
  • Errores de transporte persistentes → reporta el último error textualmente y detente.
  • viralprinter o ffmpeg no encontrados → reporta el binario faltante y la línea de instalación. Nunca simules una renderización.
  • Fallo de compose → el error lleva la cola de stderr de ffmpeg. Cítala, luego corrige la línea de tiempo. No ejecutes ffmpeg manualmente para sortear el compositor.
  • Errores de validación → corrige la línea de tiempo y vuelve a validar. Nunca pases una línea de tiempo inválida a compose.

Skills relacionados