Communitygithub.com

PrunaAI/pruna-skills

Úsalo cuando se desee un clip corto y simple a partir de texto o imágenes: B-roll rápido, borradores o animación de fotograma inicial/final. No cuando se necesite generación cinematográfica, máxima calidad, sincronía labial precisa o audio importado a 1080p.

¿Qué es pruna-skills?

Esta skill de PrunaAI, `p-video`, permite generar clips de video cortos y simples (hasta 20 segundos) a partir de texto, imágenes (I2V), pares de fotogramas (inicio/fin) o con sincronización básica de audio. Está diseñada para flujos de trabajo rápidos, como la creación de B-roll, borradores de escenas o animaciones transicionales, sin requerir configuraciones complejas ni máxima calidad visual. Se integra directamente con la API de Pruna (Replicate) y soporta plataformas como Claude Code, Cursor y Codex. La skill incluye guías detalladas para la creación de prompts dinámicos y fieles al contexto, diversidad generativa mediante seeds aleatorias y campos opcionales como duración, resolución (720p/1080p), FPS y modo borrador. Su uso sigue un flujo estructurado: primero se ejecuta el ritual de seed (`generation-diversity`), luego se redacta un prompt que combine dinamismo y fidelidad al brief, y finalmente se confirman los parámetros con el usuario antes de la llamada HTTP. Es importante destacar que esta skill no debe usarse para clips cinematográficos, sincronía labial o ensamblajes multi-escena; para esos casos se recomiendan skills hermanas como `p-video-2-pro`, `p-video-avatar` o `visual-transition-reel`.

Compatible con~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/PrunaAI/pruna-skills/tree/HEAD/skills/video/p-video

Preguntar en tu IA favorita

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

Documentación

Prerrequisitos

Instala y carga estas skills antes de generar (omite si ya están en contexto mediante @pruna):

SkillDescripciónInstalación
generation-diversityÚsalo al escribir cualquier prompt generativo: semilla ritual, estructura explícita, ejes de escenario y barreras de calidad antes de llamadas a API pagas.npx skills add PrunaAI/pruna-skills@generation-diversity -y
video-promptingÚsalo al crear prompts de video o movimiento para cualquier modelo generativo: dramaturgia, cámara, movimiento físicamente seguro, anclajes de fotograma y encadenamiento de clips.npx skills add PrunaAI/pruna-skills@video-prompting -y
audio-promptingÚsalo al crear prompts TTS, musicales o de ambiente para cualquier modelo de audio generativo: estilo de director, estructura de canción y capas de postproducción.npx skills add PrunaAI/pruna-skills@audio-prompting -y
pruna-apiÚsalo antes de cualquier llamada HTTP a Pruna o Replicate: credenciales, subida/sondeo/descarga, lotes paralelos y seguridad del agente.npx skills add PrunaAI/pruna-skills@pruna-api -y

O instala el conjunto completo de una vez: npx skills add PrunaAI/pruna-skills@pruna -y

Sigue las secciones Antes de generar / redacción de cada skill — no repliques el contenido de la guía aquí.

Hábito del agente

Enrutamiento: Usa `p-video` para clips simples y rápidos — borradores, B-roll ligero, movimiento corto. Para generación cinematográfica con audio generado → `p-video-2-pro`. Para 1080p, audio importado o previsualizaciones de borrador → `p-video-2`.

En la primera respuesta, nombra `p-video` entre acentos graves, confirma PRUNA_API_KEY (o detente con enlaces de registro de pruna-api), luego pide las entradas requeridas. Apertura → realización de generation-diversity antes del primer POST. Al redactar prompts de movimiento, sigue Redacción de prompt (dinámico + fiel) — no pegues ejemplos de la skill. Redirige cuando CUÁNDO NO usar sea más adecuado.

Redacción de prompt (dinámico + fiel)

Cada input.prompt debe ser fresco y específico y debe coincidir con el ritmo del usuario. La diversidad nunca anula el brief.

HacerNo hacer
Ejecuta el ritual de semilla aleatoria de generation-diversity; menciónalo; rota ≥2 ejes libres (movimiento de cámara, cambio de iluminación, textura, ritmo) cuando el brief lo permitaCopiar ejemplos curl de esta skill ("calle mojada por lluvia", "perro lanza peluche", …) o reutilizar un prompt de una sesión anterior
Fija primero los hechos requeridos por el usuario (sujeto, ritmo de acción, OPEN/MID/CLOSE cuando esté anclado por fotogramas, sincronización con narración cuando audio esté configurado)Cambiar el sujeto o movimiento por un clip "más cool" que ignore la solicitud
Estructura con la dramaturgia de video-prompting — una acción congelada por ritmo, movimiento físicamente seguro, gramática de cámaraCadenas vagas solo de ambiente ("ambiente cinematográfico, energía neón")
Cuando audio esté configurado, el movimiento y el ritmo deben coincidir con el ritmo de la narraciónDesviarse a una acción no relacionada mientras suena la voz en off
Muestra el prompt redactado + los campos de modo antes del POST cuando el usuario no haya fijado las palabrasRegeneración silenciosa con un sujeto o ritmo diferente al aprobado

Comprobación de fidelidad (antes de pagar): si eliminas el sujeto/acción/escenario nombrado por el usuario del prompt, el trabajo está mal — reescribe. Los ejes libres solo llenan lo que el brief dejó abierto.

Al mostrar un prompt redactado, sigue nombrando `p-video` (las guías ayudan a redactar; esta herramienta es la que hace la llamada).

Límite de la skill

Esta skill = una predicción p-video por invocación.

Fuera del alcance (no ejecutar desde esta skill):

  • Montaje multi-escena, concatenación, orquestación de subagentes o lotes de escenas paralelas
  • Transferencia de movimiento desde un video plantilla → p-video-animate
  • Anfitrión solo de cabeza parlante / sincronía labial sin audio de escena nativo → p-video-avatar
  • Generación cinematográfica con audio generado → p-video-2-pro
  • 1080p, audio importado o previsualizaciones de borrador → p-video-2

Si la solicitud excede un clip, detente y recomienda: image-to-video (un ritmo narrado), visual-transition-reel (visual multi-escena) o narrated-multi-scene (multi-escena + VO).

CUÁNDO NO usar

Usa una skill diferente en su lugar:

SkillDescripciónInstalación
p-video-2-proÚsalo cuando se desee un clip cinematográfico a partir de texto o fotogramas inicio/fin — anuncios de producto, tomas documentales o diálogos con audio generado. No para 1080p, pistas de audio importadas o anfitriones solo de cabeza parlante.npx skills add PrunaAI/pruna-skills@p-video-2-pro -y
p-video-2Úsalo cuando se desee un clip corto y pulido a partir de texto, imágenes o audio importado — B-roll en 1080p, animación de fotograma inicio/fin o una toma con movimiento con una pista mixta. No para clips cinematográficos con audio generado o anfitriones solo de cabeza parlante.npx skills add PrunaAI/pruna-skills@p-video-2 -y
p-video-avatarÚsalo cuando se desee una persona en cámara leyendo un guion — anfitrión con sincronía labial, portavoz o avatar narrado a partir de una foto de retrato.npx skills add PrunaAI/pruna-skills@p-video-avatar -y
p-video-animateÚsalo cuando se desee que una foto se mueva como otro video — transferencia de movimiento, remixes de baile o variaciones de rendimiento a partir de un clip plantilla.npx skills add PrunaAI/pruna-skills@p-video-animate -y
p-video-replaceÚsalo cuando se desee intercambiar una persona, atuendo o producto dentro de un metraje existente manteniendo el movimiento de cámara y el audio.npx skills add PrunaAI/pruna-skills@p-video-replace -y
p-video-editÚsalo cuando se desee editar un video existente con una instrucción de texto — recolorizar, reestilizar, eliminar o añadir objetos, cambiar entorno o iluminación, actualizar texto en pantalla o aplicar ediciones opcionales de producto y accesorios guiadas por referencia. No para un clip nuevo desde cero o montaje con ffmpeg.npx skills add PrunaAI/pruna-skills@p-video-edit -y
video-editingÚsalo al ensamblar o pulir clips ya renderizados con ffmpeg — concatenación, encadenados, subtítulos y leyendas quemadas, superposiciones de texto/logo, controles deslizantes antes/después, fondos musicales, exportación para plataformas — o al componer un video combinado HTML multicapa con Hyperframes. No para generación de video con IA, redacción de prompts o ediciones de video basadas en modelos.npx skills add PrunaAI/pruna-skills@video-editing -y

HTTP (curl)

Subida para imagen-a-video / anclajes de fotograma

curl -X POST "https://api.pruna.ai/v1/files" \
  -H "apikey: ${PRUNA_API_KEY}" \
  -F "content=@/path/to/first-frame.png"

Pasa urls.get como input.image (primer fotograma) y/o input.last_frame_image (último fotograma). Sube TTS/música de la misma manera para input.audio.

Crear (texto-a-video asíncrono — recomendado)

curl -X POST 'https://api.pruna.ai/v1/predictions' \
  -H 'Content-Type: application/json' \
  -H "apikey: ${PRUNA_API_KEY}" \
  -H 'Model: p-video' \
  -d '{
    "input": {
      "prompt": "Slow dolly in on rain-slick street at night, neon reflections, distant traffic hiss",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9"
    }
  }'

Sondea y descarga: sigue pruna-api.

Completa el ritual de semilla aleatoria de generation-diversity antes de escribir prompts — no pases la cadena del ritual como seed de la API.

Primer / último fotograma (transición visual)

curl -X POST 'https://api.pruna.ai/v1/predictions' \
  -H 'Content-Type: application/json' \
  -H "apikey: ${PRUNA_API_KEY}" \
  -H 'Model: p-video' \
  -d '{
    "input": {
      "prompt": "OPEN: hold wide on wet alley, neon flicker. MID: slow dolly in, rain ticks on pavement. CLOSE: settle on end pose.",
      "image": "https://api.pruna.ai/v1/files/START_ID",
      "last_frame_image": "https://api.pruna.ai/v1/files/END_ID",
      "duration": 5,
      "resolution": "720p",
      "fps": 24
    }
  }'

Triple anclaje de escena (image + last_frame_image + audio)

curl -X POST 'https://api.pruna.ai/v1/predictions' \
  -H 'Content-Type: application/json' \
  -H "apikey: ${PRUNA_API_KEY}" \
  -H 'Model: p-video' \
  -d '{
    "input": {
      "prompt": "Dog tosses plush upward, tail wagging, motion matches narrator, warm light",
      "image": "https://api.pruna.ai/v1/files/SCENE_START",
      "last_frame_image": "https://api.pruna.ai/v1/files/SCENE_END",
      "audio": "https://api.pruna.ai/v1/files/SCENE_NARRATION",
      "resolution": "720p",
      "fps": 24,
      "save_audio": true
    }
  }'

Omite duration cuando audio esté configurado. La duración del clip = min(longitud del audio, 20s) — mantén TTS ≤ ~19s (ffprobe antes de renderizar).

Antes de generar

  1. Completa el orden de lectura de los Prerrequisitos (generation-diversity → video-prompting).
  2. Semilla ritual → redacta un prompt de movimiento dinámico + fiel (sección anterior) → confirma modo (T2V / I2V / par de fotogramas / audio), duration (a menos que esté guiado por audio), resolution, fps, draft y prompt con el usuario.
  3. Notas de Pruna: cuando image está configurado, aspect_ratio se ignora. Con audio, omite duration y establece save_audio: true para mantener la narración. Prefiere VO subida sobre post-mux. Si la solicitud es multi-escena — detente (ver Límite de la skill).

Entrada requerida

  • prompt (cadena)

Campos opcionales comunes

CampoRol
imagePrimer fotograma — anclaje I2V; cuando está configurado, se ignora aspect_ratio
last_frame_imageImagen fija de estado final opcional
audioCondicionado por audio; la duración sigue al audio (limitado a 20s); flac/mp3/wav
duration1–20s (ignorado si audio está configurado)
resolution720p (predeterminado) o 1080p
fps24 (predeterminado) o 48
aspect_ratioCuando no hay image: 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 1:1
drafttrue ≈ vista previa 4× más rápida/barata; false = final
save_audioMantener el audio generado por el modelo o subido en la salida
seed, prompt_upsampling, disable_safety_filterReproducibilidad / política del cliente

Relacionados

Skills relacionadas:

SkillDescripciónInstalación
p-video-2-proÚsalo cuando se desee un clip cinematográfico a partir de texto o fotogramas inicio/fin — anuncios de producto, tomas documentales o diálogos con audio generado. No para 1080p, pistas de audio importadas o anfitriones solo de cabeza parlante.npx skills add PrunaAI/pruna-skills@p-video-2-pro -y
gemini-3.1-flash-ttsÚsalo cuando se necesite narración hablada o voz en off — pistas explicativas, líneas documentales o voz para emparejar con video generado.npx skills add PrunaAI/[email protected] -y
image-to-videoÚsalo cuando se desee un ritmo de cortometraje a partir de imágenes — una escena narrada, momento de historia o B-roll cinematográfico con voz en off opcional.npx skills add PrunaAI/pruna-skills@image-to-video -y
visual-transition-reelÚsalo cuando se desee un montaje con transiciones entre tomas — reel de secuencia de acción o pieza multi-escena donde la narración es opcional.npx skills add PrunaAI/pruna-skills@visual-transition-reel -y
narrated-multi-sceneÚsalo cuando se desee una historia en varias partes con voz en off — B-roll episódico, promocional por capítulos o varias escenas de video enlazadas sin diálogo en cámara.npx skills add PrunaAI/pruna-skills@narrated-multi-scene -y
p-video-avatarÚsalo cuando se desee una persona en cámara leyendo un guion — anfitrión con sincronía labial, portavoz o avatar narrado a partir de una foto de retrato.npx skills add PrunaAI/pruna-skills@p-video-avatar -y
p-video-animateÚsalo cuando se desee que una foto se mueva como otro video — transferencia de movimiento, remixes de baile o variaciones de rendimiento a partir de un clip plantilla.npx skills add PrunaAI/pruna-skills@p-video-animate -y
video-editingÚsalo al ensamblar o pulir clips ya renderizados con ffmpeg — concatenación, encadenados, subtítulos y leyendas quemadas, superposiciones de texto/logo, controles deslizantes antes/después, fondos musicales, exportación para plataformas — o al componer un video combinado HTML multicapa con Hyperframes. No para generación de video con IA, redacción de prompts o ediciones de video basadas en modelos.npx skills add PrunaAI/pruna-skills@video-editing -y

Individual skills in this repo

This repo contains 13 individual skills — each has its own dedicated page.

PrunaAI/pruna-skills

Use when someone needs spoken narration or voiceover — explainer tracks, documentary lines, or voice to pair with generated video.

PrunaAI/pruna-skills

Use when someone wants an original AI song with vocals — sung lyrics, a style prompt track, or source audio for a music video.

PrunaAI/pruna-skills

Use when someone needs word-level timestamps from audio — lyric alignment, cut-safe line boundaries, or caption source timing before burn-in with video-editing.

PrunaAI/pruna-skills

Use before any Pruna or Replicate HTTP call — credentials, upload/poll/download, parallel batches, and agent safety.

PrunaAI/pruna-skills

Use when assembling or polishing already-rendered clips with ffmpeg — concat, crossfades, burned captions and subtitles, text/logo overlays, before/after sliders, background music beds, platform export — or when composing a multi-layer HTML combination video with Hyperframes. Not for AI video generation, prompt craft, or model-based video edits.

PrunaAI/pruna-skills

Use when crafting video or motion prompts for any generative model — dramaturgy, camera, physics-safe motion, frame anchors, and clip chaining.

PrunaAI/pruna-skills

Use when someone wants to edit an existing photo — change outfits or backgrounds, compose from reference images, or apply prompt-driven edits.

PrunaAI/pruna-skills

Use when someone explicitly wants the fastest, cheapest photo generation — mood boards, bulk panels, or quick iterations — not when controlled photoreal or in-image text is needed.

PrunaAI/pruna-skills

Use when someone wants virtual try-on — dress a person in clothes from reference photos for fashion or ecommerce.

PrunaAI/pruna-skills

Use when installing the full Pruna generative media suite — all guides, tools, and workflows in one package.

PrunaAI/pruna-skills

Use when someone wants a cinematic clip from text or start/end frames — product ads, documentary shots, or dialogue with generated audio. Not for 1080p, imported audio tracks, or talking-head-only hosts.

PrunaAI/pruna-skills

Use when someone wants a polished short clip from text, images, or imported audio — 1080p B-roll, start/end frame animation, or a motion shot with a mixed track. Not for cinematic generated-audio clips or talking-head-only hosts.

PrunaAI/pruna-skills

Use when someone wants to edit an existing video with a text instruction — recolor, restyle, remove or add objects, change environment or lighting, update on-screen text, or apply optional reference-guided product and accessory edits. Not for a new clip from scratch or ffmpeg assembly.

Skills relacionados