Communitygithub.com

PrunaAI/pruna-skills

Use 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.

O que é pruna-skills?

Esta skill especializada em edição de imagens permite modificar fotos existentes com precisão cirúrgica, trocando elementos como roupas, fundos ou compondo novas cenas a partir de múltiplas referências — tudo controlado por prompts textuais. Diferente de geração do zero, ela preserva a identidade do sujeito, pose, iluminação e demais atributos que o usuário deseja manter, garantindo edições fiéis ao pedido original. A skill integra-se ao ecossistema PrunaAI (via API HTTP) e deve ser usada em conjunto com as skills auxiliares `generation-diversity`, `image-prompting` e `pruna-api` para garantir diversidade de prompt, boas práticas de composição e chamadas de API seguras. O fluxo típico envolve travar a alteração desejada e os elementos a preservar, fazer upload de até 5 referências, gerar o prompt de edição seguindo a fórmula 'Mude [coisa específica]. Mantenha [identidade/pose/iluminação/fundo] idênticos.', e submeter a requisição assíncrona para a API, com checagem de fidelidade antes do pagamento. Ideal para e-commerce, moda, retratos e qualquer cenário que exija edições controladas sem reinventar a cena.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/PrunaAI/pruna-skills/tree/HEAD/skills/image/p-image-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 — semente ritual, 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
image-promptingUse ao criar prompts de imagem estática para qualquer modelo generativo — composição, fichas de identidade, edições, provador virtual e personas fotorrealistas.npx skills add PrunaAI/pruna-skills@image-prompting -y
video-promptingUse ao criar prompts de vídeo ou movimento para qualquer modelo generativo — dramaturgia, câmera, movimento fisicamente seguro, â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 / craft de cada skill — não repita o conteúdo do guia aqui.

Hábito do agente

Na primeira resposta, nomeie `p-image-edit` entre crases, confirme PRUNA_API_KEY e então peça a foto de origem (e o resumo da edição). Abra a triagem → triagem de esclarecimento generation-diversity quando necessário. Elabore edições com Craft de prompt (dinâmico + fiel). Redirecione para p-image-try-on quando o trabalho for ajuste de vestuário a partir de fotos de produto.

Craft de prompt (dinâmico + fiel)

Prompts de edição são cirúrgicos e bloqueados pela solicitação. Mude apenas o que o usuário pediu; mantenha todo o resto idêntico. A diversidade se aplica a como você formula a mudança — não para inventar uma nova cena.

FaçaNão faça
Fórmula: Mude [coisa específica]. Mantenha [identidade / pose / iluminação / fundo] idênticos. (craft de edição de image-prompting)Melhore / reescritas só de humor que ignoram o resumo
Nomeie cada item obrigatório a manter do usuário (rosto, roupa, pose, fundo, produto)Deixe de fora cláusulas de manutenção e espere que o modelo as preserve
Semente ritual nova de generation-diversity antes de rascunhar; varie a redação livre (materiais, hex, nuances de câmera) quando o resumo permitirCopie a amostra desta skill (soft gradient) quando o usuário pediu outra coisa
Aponte referências ao compor: rosto da imagem 1, roupa da imagem 2Vago combine estas imagens
Mostre o prompt de edição antes do POST quando a redação não estiver bloqueadaEdição silenciosa que muda sujeito, espécie, idade ou regiões não solicitadas

Verificação de fidelidade (antes de pagar): o prompt ainda deve satisfazer a mudança solicitada pelo usuário e cada item declarado a manter. Se faltar um item, adicione-o. Não "tempere" o fundo/elenco quando pediram apenas troca de fundo.

Quando NÃO usar

Use uma skill diferente:

SkillDescriçãoInstalação
p-imageUse quando alguém quiser explicitamente a geração de fotos mais rápida e barata — quadros de humor, painéis em massa ou iterações rápidas — não quando for necessário fotorrealismo controlado ou texto dentro da imagem.npx skills add PrunaAI/pruna-skills@p-image -y
p-image-try-onUse quando alguém quiser provador virtual — vestir uma pessoa com roupas de fotos de referência para moda ou e-commerce.npx skills add PrunaAI/pruna-skills@p-image-try-on -y
p-image-upscaleUse quando alguém quiser aumentar a resolução ou nitidez de uma imagem existente para impressão, recortes grandes ou entrega de maior qualidade.npx skills add PrunaAI/pruna-skills@p-image-upscale -y

HTTP (curl)

Upload de referências

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

Use o urls.get de cada resposta em input.images.

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-image-edit' \
  -d '{
    "input": {
      "prompt": "Mude o fundo para gradiente suave, mantenha o sujeito idêntico",
      "images": ["https://api.pruna.ai/v1/files/FILE_ID"],
      "aspect_ratio": "9:16"
    }
  }'

Faça poll e download: siga pruna-api.

Complete o ritual de semente aleatória de 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 — apenas teste rápido)

curl -X POST 'https://api.pruna.ai/v1/predictions' \
  -H 'Content-Type: application/json' \
  -H "apikey: ${PRUNA_API_KEY}" \
  -H 'Model: p-image-edit' \
  -H 'Try-Sync: true' \
  -d '{
    "input": {
      "prompt": "Mude o fundo para gradiente suave, mantenha o sujeito idêntico",
      "images": ["https://api.pruna.ai/v1/files/FILE_ID"],
      "aspect_ratio": "9:16"
    }
  }'

Fluxo de edição

Siga o fluxo de prompt de imagem estática de generation-diversity (seção de edição):

  1. Trave mudança + itens a manter — pedido cirúrgico do usuário; fórmula em Craft de prompt (dinâmico + fiel).
  2. Upload de referências — POST /v1/files; urls.get → input.images (1–5). Nunca invente URLs de arquivo.
  3. Semente ritual → rascunhe o prompt de edição (craft de edição de image-prompting) → verificação de fidelidade (toda cláusula de manutenção presente).
  4. Confirme — prompt, referências, aspect_ratio, turbo (desligado para edições difíceis).
  5. POST — curl assíncrono abaixo; checklist antes de upscale/vídeo.

Proporção de aspecto: prefira match_input_image para edições; a saída deve manter a proporção da placa — se houver desvio, tente novamente com a mesma URL de referência e cláusulas de manutenção explícitas.

Nota Pruna: pipelines de avatar — edite a partir da URL hero ampliada e bloqueada; amplie novamente antes de p-video* — nunca passe URLs de edição brutas para modelos de vídeo.

Não é edição: novo sujeito do zero → p-image. Ajuste de vestuário a partir de fotos de produto → p-image-try-on.

Múltiplas referências (até 5): indexe as referências por papel — ex. composta de três referências: rosto da imagem 1, roupa da imagem 2, café da imagem 3; turbo: false para composições difíceis. Padrão completo em image-prompting p-image-edit-prompting.

Entrada necessária

  • prompt (string)
  • images (array de 1 a 5 URLs, tipicamente https://api.pruna.ai/v1/files/{id})

Campos opcionais comuns

  • aspect_ratio: match_input_image, 1:1, 16:9, 9:16, etc.
  • turbo (booleano, padrão true; desligue para edições mais difíceis)
  • seed, disable_safety_checker

Próximos passos típicos

Etapas comuns após esta skill:

SkillDescriçãoInstalação
p-image-upscaleUse quando alguém quiser aumentar a resolução ou nitidez de uma imagem existente para impressão, recortes grandes ou entrega de maior qualidade.npx skills add PrunaAI/pruna-skills@p-image-upscale -y
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, trilhas de áudio importadas ou apresentadores apenas com cabeça falante.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 trilha mista. Não para clipes cinematográficos com áudio gerado ou apresentadores apenas com cabeça falante.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-editUse quando alguém quiser editar um vídeo existente com uma instrução textual — recolorir, reestilizar, remover ou adicionar objetos, mudar ambiente ou iluminação, atualizar texto na tela ou aplicar edições opcionais de produto e acessórios guiadas por referência. Não para um novo clipe do zero ou montagem ffmpeg.npx skills add PrunaAI/pruna-skills@p-video-edit -y
p-video-avatarUse quando alguém quiser uma pessoa na câmera falando um roteiro — apresentador com sincronia labial, porta-voz ou avatar narrado a partir de uma foto de retrato.npx skills add PrunaAI/pruna-skills@p-video-avatar -y
avatar-multi-sceneUse quando alguém quiser a mesma pessoa apresentando vários clipes — UGC multi-segmento, reels de comparação ou cenas mistas de fala e animação com continuidade.npx skills add PrunaAI/pruna-skills@avatar-multi-scene -y
narrated-multi-sceneUse quando alguém quiser uma história em várias partes com narração — B-roll episódico, promoção em capítulos ou várias cenas de vídeo vinculadas sem diálogo em câmera.npx skills add PrunaAI/pruna-skills@narrated-multi-scene -y
visual-transition-reelUse quando alguém quiser uma montagem com transições entre tomadas — reel de sequência de ação ou peça de várias cenas onde a narração é opcional.npx skills add PrunaAI/pruna-skills@visual-transition-reel -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 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.

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