Communitygithub.com

PrunaAI/pruna-skills

Use quando alguém quiser editar um vídeo existente com uma instrução de texto — recolorir, reestilizar, remover ou adicionar objetos, alterar ambiente ou iluminação, atualizar texto na tela ou aplicar edições opcionais guiadas por referência de produto e acessórios. Não use para criar um novo clipe do zero ou montagem com ffmpeg.

O que é pruna-skills?

Esta skill permite que agentes de IA editem vídeos existentes com instruções textuais precisas, alterando atributos como cor, estilo, objetos, ambiente, iluminação ou texto na tela, sem recriar o clipe do zero. Ela utiliza a API Pruna (modelo p-video-edit) para aplicar uma única alteração principal por execução, preservando elementos não mencionados como câmera, movimento, áudio e objetos secundários. A skill é ideal para refinamentos cirúrgicos e fiéis, como trocar o céu de um clipe para um pôr do sol ou adicionar um acessório a partir de uma imagem de referência, e suporta upload de vídeos de até 15 segundos com até 4 imagens opcionais de referência. Ela se integra com outras skills do ecossistema PrunaAI (como p-video-replace para troca de personagens) e segue um processo de intake que confirma a chave de API, aplica rituais de seed e elabora prompts estruturados antes de chamar o endpoint de pagamento por segundo gerado.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Pré-requisitos

Instale e carregue estas skills antes de gerar (pule se já estiverem em contexto via @pruna):

SkillDescriçãoInstalação
generation-diversityUse ao escrever qualquer prompt generativo — ritual de seed, estrutura explícita, eixos de cenário e portões de qualidade antes de chamadas pagas de API.npx skills add PrunaAI/pruna-skills@generation-diversity -y
video-promptingUse ao criar prompts de vídeo ou movimento para qualquer modelo generativo — dramaturgia, câmera, movimento seguro para física, âncoras de quadro e encadeamento de clipes.npx skills add PrunaAI/pruna-skills@video-prompting -y
pruna-apiUse antes de qualquer chamada HTTP Pruna ou Replicate — credenciais, upload/poll/download, lotes paralelos e segurança do agente.npx skills add PrunaAI/pruna-skills@pruna-api -y

Ou instale o pacote completo de uma vez: npx skills add PrunaAI/pruna-skills@pruna -y

Siga as seções Antes de gerar / elabore de cada skill — não repita o conteúdo do guia aqui.

Hábito do agente

Na primeira resposta, nomeie `p-video-edit` entre crases, confirme PRUNA_API_KEY (ou pare com links de cadastro do pruna-api), então peça o vídeo de origem (máx. 15s) e o resumo da edição. Abra intake → intake de esclarecimento do generation-diversity antes do primeiro POST. Elabore edições com Elaboração de prompt (dinâmica + fiel) — não cole exemplos da skill. Redirecione quando Quando NÃO usar se encaixar melhor.

Elaboração de prompt (dinâmica + fiel)

prompt é cirúrgico e bloqueado à solicitação. Uma alteração principal por execução. Descreva o estado final desejado, então nomeie o que deve permanecer inalterado. Altere apenas o que o usuário pediu; mantenha câmera, movimento, áudio e elementos não mencionados idênticos.

FaçaNão faça
Fórmula: Altere apenas [X]. Preserve [geometria / movimento / câmera / iluminação / sujeitos não mencionados].melhore vago / reescritas só de humor que inventam uma nova cena
Nomeie cada item que deve permanecer do usuário (sujeito, trajeto da câmera, iluminação, adereços)Remova cláusulas de keep e espere que o modelo as preserve
Ritual de seed antes de elaborar; redação nova para cláusulas de keep quando o resumo permitirCopie a amostra desta skill (sunset sky) quando o usuário descreveu uma edição diferente
Aponte para referências quando usadas: adicione o acessório da primeira referênciause a referência vago, sem slot de origem
Mostre prompt antes do POST quando a redação não estiver bloqueadaEdição silenciosa que altera câmera, elenco ou regiões não solicitadas

Verificação de fidelidade (antes de pagar): o prompt ainda deve satisfazer a alteração do usuário e cada item declarado que deve permanecer. Não “tempere” extras quando eles pediram um único atributo ou edição de ambiente.

Trabalhos fracos (evite ou avise): uma cena/enredo totalmente novo; adicionar um objeto com seu próprio movimento independente (especialmente uma nova forma na mão); alterar ângulo, movimento ou zoom da câmera.

Limite da skill

p-video-editp-video-replace
Pergunta do usuárioAlterar a cor / ambiente / objeto / texto / iluminação neste clipe?Substituir esta pessoa neste vídeo?
ObjetivoEdição por instrução do clipe de origemTrocar identidade no metraja existente
Imagens de referênciaOpcionais images — 0 a 4Obrigatórias images — 1 a 4
Campo de promptpromptinstruction_prompt

Use p-video-replace quando o trabalho for uma troca de personagem a partir de imagens de referência obrigatórias. Use esta skill para edições guiadas por prompt de atributo, ambiente, objeto, texto ou iluminação.

Quando NÃO usar

Use uma skill diferente:

SkillDescriçãoInstalação
p-video-2-proUse quando alguém quiser um clipe cinematográfico a partir de texto ou quadros inicial/final — anúncios de produto, tomadas documentais ou diálogo com áudio gerado. Não para 1080p, faixas de áudio importadas ou apresentadores apenas com talking-head.npx skills add PrunaAI/pruna-skills@p-video-2-pro -y
p-video-2Use quando alguém quiser um clipe curto polido a partir de texto, imagens ou áudio importado — B-roll 1080p, animação de quadro inicial/final ou uma tomada com movimento com faixa mista. Não para clipes cinematográficos com áudio gerado ou apresentadores apenas com talking-head.npx skills add PrunaAI/pruna-skills@p-video-2 -y
p-videoUse quando alguém quiser um clipe curto simples a partir de texto ou imagens — B-roll rápido, rascunhos ou animação de quadro inicial/final. Não quando o resumo precisar de geração cinematográfica, máxima qualidade, sincronia labial precisa ou áudio importado em 1080p.npx skills add PrunaAI/pruna-skills@p-video -y
p-video-replaceUse quando alguém quiser trocar uma pessoa, roupa ou produto dentro de um metraje existente mantendo o movimento da câmera e o áudio.npx skills add PrunaAI/pruna-skills@p-video-replace -y
p-video-animateUse quando alguém quiser que uma foto se mova como outro vídeo — transferência de movimento, remixes de dança ou variações de performance a partir de um clipe modelo.npx skills add PrunaAI/pruna-skills@p-video-animate -y
video-editingUse ao montar ou polir clipes já renderizados com ffmpeg — concatenação, crossfades, legendas e subtítulos incorporados, sobreposições de texto/logotipo, controles deslizantes antes/depois, faixas de música de fundo, exportação para plataforma — ou ao compor um vídeo de combinação HTML multicamada com Hyperframes. Não para geração de vídeo por IA, elaboração de prompts ou edições de vídeo baseadas em modelo.npx skills add PrunaAI/pruna-skills@video-editing -y

HTTP (curl)

Fazer upload do vídeo de origem

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

Use o urls.get da resposta em input.video. Duração máxima do vídeo de origem: 15 segundos.

Imagens de referência opcionais

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

Use cada urls.get da resposta em input.images (até 4; jpg, jpeg, png, webp).

Criar (assí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/video-origem-abc123",
      "prompt": "Altere apenas o céu para um pôr do sol. Preserve o sujeito, o trajeto da câmera e a iluminação no primeiro plano."
    }
  }'

Consulte e baixe: siga pruna-api. A duração da saída segue o vídeo de origem. O faturamento é por segundo retornado ($0.045 padrão, $0.025 rascunho). Limite de taxa: 50 requisições por minuto.

Complete o ritual de seed aleatório do generation-diversity antes de escrever prompts — não passe a string do ritual como seed da API. seed opcional apenas quando o usuário solicitar reprodutibilidade.

Criar (síncrono — teste rápido apenas)

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/video-origem-abc123",
      "prompt": "Altere apenas o céu para um pôr do sol. Preserve o sujeito, o trajeto da câmera e a iluminação no primeiro plano.",
      "draft": true
    }
  }'

Antes de gerar

  1. Complete a ordem de leitura dos Pré-requisitos (generation-diversity → video-prompting).
  2. Ritual de seed → elabore um prompt dinâmico + fiel (seção acima) → confirme video (≤15s), prompt, images opcionais (0–4), draft, save_audio e a intenção da edição (atributo / remover / adicionar / ambiente / religar / texto / guiado por referência).
  3. Notas da Pruna: uma alteração principal por execução. A correspondência de identidade ou produto vem de images opcionais; a instrução de edição reside em prompt. Alvos vagos e cenas totalmente novas reduzem a qualidade. Não envie um campo task — ele não está na API pública.

Entrada obrigatória

  • video (string URL): vídeo de origem a ser editado. Duração máxima: 15 segundos
  • prompt (string): instrução de texto descrevendo a edição

Campos opcionais comuns

  • images (array de até 4 URLs de string): imagem(ns) de referência para edição guiada por referência (jpg, jpeg, png, webp)
  • prompt_upsampling (boolean, padrão true)
  • draft (boolean, padrão false): visualização mais rápida e de qualidade inferior; faturado a $0.025 por segundo de saída
  • save_audio (boolean, padrão true)
  • seed (integer): definido apenas para repetições reproduzíveis

Próximos passos típicos

Acompanhamentos comuns após esta skill:

SkillDescriçãoInstalação
p-video-replaceUse quando alguém quiser trocar uma pessoa, roupa ou produto dentro de um metraje existente mantendo o movimento da câmera e o áudio.npx skills add PrunaAI/pruna-skills@p-video-replace -y
p-image-editUse quando alguém quiser editar uma foto existente — trocar roupas ou fundos, compor a partir de imagens de referência ou aplicar edições guiadas por prompt.npx skills add PrunaAI/pruna-skills@p-image-edit -y
video-editingUse ao montar ou polir clipes já renderizados com ffmpeg — concatenação, crossfades, legendas e subtítulos incorporados, sobreposições de texto/logotipo, controles deslizantes antes/depois, faixas de música de fundo, exportação para plataforma — ou ao compor um vídeo de combinação HTML multicamada com Hyperframes. Não para geração de vídeo por IA, elaboração de prompts ou edições de vídeo baseadas em modelo.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.

Habilidades Relacionadas