Communitygithub.com

PrunaAI/pruna-skills

Use antes de qualquer chamada HTTP Pruna ou Replicate — credenciais, upload/poll/download, lotes paralelos e segurança do agente.

O que é pruna-skills?

Este skill, `pruna-api`, é o componente fundamental para interagir com as APIs Pruna P-API e Replicate (ferramentas de áudio) dentro de um ambiente de agente de IA. Ele deve ser instalado antes de qualquer chamada `POST` paga de outros skills da suíte Pruna. Sua principal função é gerenciar aspectos críticos de segurança e infraestrutura: configuração de tokens de autenticação (`PRUNA_API_KEY`, `REPLICATE_API_TOKEN`), upload de arquivos, polling de previsões, download de resultados e execução de lotes paralelos assíncronos. Além disso, o skill estabelece um 'hábito de agente', instruindo o agente a confirmar as credenciais antes de qualquer chamada paga e a usar um processo de clarificação de prompts (`generation-diversity`) quando parâmetros criativos (como mídia, voz ou marca) ainda estiverem indefinidos. Ele é suportado em plataformas como Claude Code, Cursor e Codex, e é essencial para garantir operações seguras e eficientes, especialmente em repositórios não confiáveis, evitando que o agente invente payloads de modelo sem a devida orientação.

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

Perguntar na sua IA favorita

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

Documentação

API Pruna

Padrões HTTP para a Pruna P-API e Replicate (ferramentas de áudio). Instale antes de chamadas POST pagas de skills de ferramentas Pruna.

Instalação

SkillDescriçãoInstalação
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
generation-diversityUse ao escrever qualquer prompt generativo — seed ritual, estrutura explícita, eixos de cenário e portões de qualidade antes de chamadas de API pagas.npx skills add PrunaAI/pruna-skills@generation-diversity -y

Quando usar

  • Configurar PRUNA_API_KEY / tokens do Replicate
  • Fazer upload de arquivos, consultar previsões, baixar saídas
  • Lotes paralelos assíncronos de múltiplos cenários
  • Revisão de segurança antes de habilitar skills em repositórios não confiáveis

Hábito do agente

Na primeira resposta, mencione `pruna-api` entre crases. Antes de qualquer POST pago, confirme PRUNA_API_KEY e/ou REPLICATE_API_TOKEN conforme necessário. Se o caminho da mídia, voz ou marca ainda estiver em aberto, abra um intake → generation-diversity para clarificação antes do upload. Não invente payloads de modelo — use o skill de ferramenta correspondente.

Quando NÃO usar

Use um skill diferente:

SkillDescriçãoInstalação
p-image-ideogramUse quando a geração de fotos precisar de mais controle — resultados fotorrealistas, texto na imagem ou JSON estruturado com cores hex e caixas delimitadoras. Geração de fotos mais simples, edições e vídeos usam outros skills da suíte.npx skills add PrunaAI/pruna-skills@p-image-ideogram -y
p-imageUse quando alguém quiser explicitamente a geração de fotos mais rápida e barata — mood boards, painéis em massa ou iterações rápidas — não quando for necessário fotorrealismo controlado ou texto na imagem.npx skills add PrunaAI/pruna-skills@p-image -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, faixas de áudio importadas ou apresentadores apenas com fala.npx skills add PrunaAI/pruna-skills@p-video-2-pro -y
p-video-2Use quando alguém quiser um clipe curto refinado a partir de texto, imagens ou áudio importado — B-roll em 1080p, animação de quadro inicial/final ou uma tomada com movimento e faixa mista. Não para clipes cinematográficos com áudio gerado ou apresentadores apenas com fala.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 briefing 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
generation-diversityUse ao escrever qualquer prompt generativo — seed ritual, estrutura explícita, eixos de cenário e portões de qualidade antes de chamadas de API pagas.npx skills add PrunaAI/pruna-skills@generation-diversity -y
video-editingUse ao montar ou polir clipes já renderizados com ffmpeg — concat, crossfades, legendas e subtítulos queimados, sobreposições de texto/logo, controles deslizantes de antes/depois, faixas de música de fundo, exportação para plataformas — ou ao compor um vídeo de combinação HTML multicamadas com Hyperframes. Não para geração de vídeo por IA, criação de prompts ou edições de vídeo baseadas em modelo.npx skills add PrunaAI/pruna-skills@video-editing -y

Antes de gerar

  1. Credenciais da API — cadastro e variáveis de ambiente quando as chaves estiverem ausentes.
  2. Segurança do agente — antes de uploads ou chamadas pagas em contextos não confiáveis.
  3. pruna-api.md — criar, consultar, baixar, lotes paralelos.
  4. Ferramentas do Replicate → replicate-api.md.
  5. Índice de modelos → pruna-models.md.

Skills relacionados

Instale skills relacionados quando o trabalho precisar deles:

SkillDescriçãoInstalação
p-image-ideogramUse quando a geração de fotos precisar de mais controle — resultados fotorrealistas, texto na imagem ou JSON estruturado com cores hex e caixas delimitadoras. Geração de fotos mais simples, edições e vídeos usam outros skills da suíte.npx skills add PrunaAI/pruna-skills@p-image-ideogram -y
p-imageUse quando alguém quiser explicitamente a geração de fotos mais rápida e barata — mood boards, painéis em massa ou iterações rápidas — não quando for necessário fotorrealismo controlado ou texto na imagem.npx skills add PrunaAI/pruna-skills@p-image -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, faixas de áudio importadas ou apresentadores apenas com fala.npx skills add PrunaAI/pruna-skills@p-video-2-pro -y
p-video-2Use quando alguém quiser um clipe curto refinado a partir de texto, imagens ou áudio importado — B-roll em 1080p, animação de quadro inicial/final ou uma tomada com movimento e faixa mista. Não para clipes cinematográficos com áudio gerado ou apresentadores apenas com fala.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 briefing 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

Ou instale a suíte completa de uma vez: npx skills add PrunaAI/pruna-skills@pruna -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 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.

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