Communitygithub.com

PrunaAI/pruna-skills

Úsalo cuando alguien quiera editar un video existente con una instrucción de texto: recolorizar, reestilizar, eliminar o agregar objetos, cambiar el entorno o la iluminación, actualizar texto en pantalla o aplicar ediciones opcionales guiadas por referencia de productos y accesorios. No es para crear un clip desde cero ni para ensamblaje con ffmpeg.

¿Qué es pruna-skills?

Esta habilidad (skill) permite a un agente de IA editar videos existentes mediante instrucciones de texto precisas, como cambiar el color, el estilo, agregar o eliminar objetos, modificar el entorno o la iluminación, y actualizar texto en pantalla. También admite ediciones guiadas por imágenes de referencia (hasta 4) para productos o accesorios. Está diseñada para agentes como Claude Code, Cursor o Codex y se integra con la API de Pruna, utilizando el modelo `p-video-edit`. Su flujo de trabajo prioriza la fidelidad al video original: se especifica qué cambiar y qué debe permanecer igual (cámara, movimiento, iluminación, sujetos no mencionados). Requiere instalar habilidades previas (`generation-diversity`, `video-prompting`, `pruna-api`) y seguir un ritual de semilla antes de generar el prompt. Soporta peticiones asíncronas y síncronas, con opciones de borrador para previsualizaciones rápidas. Factura por segundo de video devuelto ($0.045 estándar, $0.025 borrador). No se debe usar para reemplazar personas (eso es `p-video-replace`) ni para crear videos desde cero.

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

Preguntar en tu IA favorita

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

Documentación

Requisitos previos

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

HabilidadDescripciónInstalación
generation-diversityÚsala al escribir cualquier prompt generativo: semilla ritual, estructura explícita, ejes de escenario y compuertas de calidad antes de llamadas a API de pago.npx skills add PrunaAI/pruna-skills@generation-diversity -y
video-promptingÚsala al crear prompts de video o movimiento para cualquier modelo generativo: dramaturgia, cámara, movimiento físicamente seguro, anclas de fotograma y encadenamiento de clips.npx skills add PrunaAI/pruna-skills@video-prompting -y
pruna-apiÚsala antes de cualquier llamada HTTP a Pruna o Replicate: credenciales, subida/consulta/descarga, lotes paralelos y seguridad del agente.npx skills add PrunaAI/pruna-skills@pruna-api -y

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

Sigue las secciones Antes de generar / elaboración de cada habilidad; no repitas el contenido de la guía aquí.

Hábito del agente

En la primera respuesta, nombra `p-video-edit` entre comillas invertidas, confirma PRUNA_API_KEY (o detente con enlaces de registro de pruna-api), luego pregunta por el video fuente (máx. 15 s) y el resumen de la edición. Apertura de ingesta → ingesta de clarificación de generation-diversity antes del primer POST. Redacta las ediciones con Elaboración de prompt (dinámico + fiel) — no pegues ejemplos de la habilidad. Redirige cuando Cuándo NO usarlo sea más adecuado.

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

El prompt es quirúrgico y bloqueado por solicitud. Un cambio principal por ejecución. Describe el estado final deseado, luego nombra lo que debe permanecer igual. Cambia solo lo que el usuario pidió; mantén idénticos la cámara, el movimiento, el audio y los elementos no mencionados.

SíNo
Fórmula: Cambia solo [X]. Conserva [geometría / movimiento / cámara / iluminación / sujetos no mencionados].Cambios vagos como mejóralo / reescrituras solo de ambiente que inventan una nueva escena
Nombra todo lo que debe conservarse del usuario (sujeto, trayectoria de cámara, iluminación, accesorios)Omite las cláusulas de conservación y esperas que el modelo las preserve
Semilla ritual antes de redactar; redacción fresca para las cláusulas de conservación cuando el resumen lo permitaCopias los ejemplos de esta habilidad (cielo al atardecer) cuando el usuario describió una edición diferente
Señala las referencias cuando se usen: agrega el accesorio de la primera referenciaVago usa la referencia sin indicar la fuente
Muestra el prompt antes del POST cuando la redacción no esté bloqueadaEdición silenciosa que cambia la cámara, el elenco o regiones no solicitadas

Verificación de fidelidad (antes de pagar): el prompt debe seguir satisfaciendo el cambio del usuario y todas las cláusulas de conservación indicadas. No “aderezos” extras cuando pidieron un solo atributo o edición de entorno.

Trabajos débiles (evitar o advertir): una escena/trama completamente nueva; agregar un objeto con su propio movimiento independiente (especialmente una forma nueva en la mano); cambiar el ángulo de cámara, el movimiento de cámara o el zoom.

Límite de la habilidad

p-video-editp-video-replace
Pregunta del usuario¿Cambiar el color / entorno / objeto / texto / iluminación en este clip?¿Reemplazar a esta persona en este video?
ObjetivoEdición por instrucción del clip fuenteIntercambiar identidad en el metraje existente
Imágenes de referenciaOpcional images — 0 a 4Obligatorio images — 1 a 4
Campo de promptpromptinstruction_prompt

Usa p-video-replace cuando el trabajo sea un intercambio de personaje a partir de imágenes fijas de referencia obligatorias. Usa esta habilidad para ediciones de atributos, entorno, objetos, texto o iluminación guiadas por prompt.

Cuándo NO usarlo

Usa una habilidad diferente en su lugar:

HabilidadDescripciónInstalación
p-video-2-proÚsala cuando alguien quiera un clip cinematográfico a partir de texto o fotogramas de inicio/fin — anuncios de productos, tomas documentales o diálogos con audio generado. No para 1080p, pistas de audio importadas o solo presentadores hablando.npx skills add PrunaAI/pruna-skills@p-video-2-pro -y
p-video-2Úsala cuando alguien quiera un clip corto y pulido a partir de texto, imágenes o audio importado — metraje B-roll en 1080p, animación de fotograma inicio/fin o una toma en movimiento con pista mixta. No para clips cinematográficos con audio generado o solo presentadores hablando.npx skills add PrunaAI/pruna-skills@p-video-2 -y
p-videoÚsala cuando alguien quiera un clip corto simple a partir de texto o imágenes — B-roll rápido, borradores o animación de fotograma inicio/fin. No cuando el resumen necesite generación cinematográfica, máxima calidad, sincronización labial precisa o audio importado en 1080p.npx skills add PrunaAI/pruna-skills@p-video -y
p-video-replaceÚsala cuando alguien quiera intercambiar una persona, vestimenta 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-animateÚsala cuando alguien quiera que una foto se mueva como otro video — transferencia de movimiento, remezclas de baile o variaciones de rendimiento a partir de un clip plantilla.npx skills add PrunaAI/pruna-skills@p-video-animate -y
video-editingÚsala para ensamblar o pulir clips ya renderizados con ffmpeg — concatenar, fundidos cruzados, subtítulos y leyendas quemados, superposiciones de texto/logotipo, controles deslizantes antes/después, pistas musicales de fondo, exportación para plataformas — o para componer un video combinado HTML multicapa con Hyperframes. No para generación de video con IA, elaboración de prompts ni ediciones de video basadas en modelos.npx skills add PrunaAI/pruna-skills@video-editing -y

HTTP (curl)

Subir video fuente

curl -X POST "https://api.pruna.ai/v1/files" \
  -H "apikey: ${PRUNA_API_KEY}" \
  -F "content=@/ruta/al/video-fuente.mp4"

Usa la respuesta urls.get en input.video. Duración máxima del video fuente: 15 segundos.

Imágenes de referencia opcionales

curl -X POST "https://api.pruna.ai/v1/files" \
  -H "apikey: ${PRUNA_API_KEY}" \
  -F "content=@/ruta/a/imagen-referencia.png"

Usa cada respuesta urls.get en input.images (hasta 4; jpg, jpeg, png, webp).

Crear (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-edit' \
  -d '{
    "input": {
      "video": "https://api.pruna.ai/v1/files/source-video-abc123",
      "prompt": "Cambia solo el cielo a un atardecer. Conserva el sujeto, la trayectoria de la cámara y la iluminación del primer plano."
    }
  }'

Consulta y descarga: sigue pruna-api. La duración de salida sigue la del video fuente. La facturación es por segundo devuelto ($0.045 estándar, $0.025 borrador). Límite de velocidad: 50 solicitudes por minuto.

Completa el ritual de semilla aleatoria de generation-diversity antes de escribir prompts — no pases la cadena del ritual como seed de la API. seed opcional solo cuando el usuario solicite reproducibilidad.

Crear (síncrono — solo prueba rápida)

curl -X POST 'https://api.pruna.ai/v1/predictions' \
  -H 'Content-Type: application/json' \
  -H "apikey: ${PRUNA_API_KEY}" \
  -H 'Model: p-video-edit' \
  -H 'Try-Sync: true' \
  -d '{
    "input": {
      "video": "https://api.pruna.ai/v1/files/source-video-abc123",
      "prompt": "Cambia solo el cielo a un atardecer. Conserva el sujeto, la trayectoria de la cámara y la iluminación del primer plano.",
      "draft": true
    }
  }'

Antes de generar

  1. Completa el orden de lectura de los Requisitos previos (generation-diversity → video-prompting).
  2. Semilla ritual → redacta un prompt dinámico + fiel (sección anterior) → confirma video (≤15 s), prompt, images opcional (0–4), draft, save_audio e intención de edición (atributo / eliminar / agregar / entorno / reiluminar / texto / guiado por referencia).
  3. Notas de Pruna: un cambio principal por ejecución. La coincidencia de identidad o producto proviene de images opcional; la instrucción de edición va en prompt. Los objetivos vagos y las escenas completamente nuevas reducen la calidad. No envíes un campo task — no está en la API pública.

Entrada requerida

  • video (string URL): video fuente a editar. Duración máxima: 15 segundos
  • prompt (string): instrucción de texto que describe la edición

Campos opcionales comunes

  • images (array de hasta 4 URLs de string): imagen(es) de referencia para edición guiada por referencia (jpg, jpeg, png, webp)
  • prompt_upsampling (booleano, por defecto true)
  • draft (booleano, por defecto false): vista previa más rápida y de menor calidad; facturado a $0.025 por segundo de salida
  • save_audio (booleano, por defecto true)
  • seed (entero): establecer solo para ejecuciones reproducibles

Pasos siguientes típicos

Seguimientos comunes después de esta habilidad:

HabilidadDescripciónInstalación
p-video-replaceÚsala cuando alguien quiera intercambiar una persona, vestimenta 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-image-editÚsala cuando alguien quiera editar una foto existente — cambiar vestimenta o fondos, componer a partir de imágenes de referencia o aplicar ediciones guiadas por prompt.npx skills add PrunaAI/pruna-skills@p-image-edit -y
video-editingÚsala para ensamblar o pulir clips ya renderizados con ffmpeg — concatenar, fundidos cruzados, subtítulos y leyendas quemados, superposiciones de texto/logotipo, controles deslizantes antes/después, pistas musicales de fondo, exportación para plataformas — o para componer un video combinado HTML multicapa con Hyperframes. No para generación de video con IA, elaboración de prompts ni 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 a simple short clip from text or images — quick B-roll, drafts, or start/end frame animation. Not when the brief needs cinematic generation, highest quality, tight lip-sync, or imported audio at 1080p.

Skills relacionados