Communitygithub.com

PrunaAI/pruna-skills

À utiliser quand quelqu'un souhaite explicitement la génération de photos la plus rapide et économique — mood boards, séries d'images ou itérations rapides — et non quand un photoréalisme contrôlé ou du texte dans l'image est nécessaire.

Qu'est-ce que pruna-skills ?

Cette compétence Pruna est conçue pour les agents d'IA qui ont besoin de générer des photos rapidement et à moindre coût, sans fioritures. Elle offre un accès direct et simplifié à l'API Pruna, en se concentrant sur la vitesse et l'économie pour des cas d'usage comme les mood boards, les séries d'images ou les itérations rapides. La compétence guide l'agent pour utiliser la commande `p-image` pour les requêtes simples et rapides, et oriente vers `p-image-ideogram` pour les besoins de contrôle plus poussé (texte dans l'image, photoréalisme avancé). Le prompt doit être rédigé de manière concrète et spécifique, en suivant un processus rigoureux de validation et de diversité. L'agent doit vérifier que la variable d'environnement `PRUNA_API_KEY` est configurée, puis suivre un flux de génération en cinq étapes : verrouillage du brief, tirage de diversité, rédaction, confirmation et appel API.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Prérequis

Installez et chargez ces compétences avant de générer (ignorer si déjà dans le contexte via @pruna):

CompétenceDescriptionInstaller
generation-diversityÀ utiliser lors de la rédaction de tout prompt génératif — rituel de seed, structure explicite, axes de scénario et contrôles de qualité avant les appels API payants.npx skills add PrunaAI/pruna-skills@generation-diversity -y
image-promptingÀ utiliser lors de la création de prompts d'image fixe pour tout modèle génératif — composition, fiches d'identité, retouches, essayage virtuel et personnages photoréalistes.npx skills add PrunaAI/pruna-skills@image-prompting -y
pruna-apiÀ utiliser avant tout appel HTTP Pruna ou Replicate — identifiants, téléversement/interrogation/téléchargement, lots parallèles et sécurité de l'agent.npx skills add PrunaAI/pruna-skills@pruna-api -y

Ou installez la suite complète en une fois : npx skills add PrunaAI/pruna-skills@pruna -y

Suivez les sections Avant de générer / craft de chaque compétence — ne répétez pas le contenu du guide ici.

Habitude de l'agent

Routage : Utilisez `p-image` pour une génération de photos simple et rapide à partir d'un prompt court. Quand la génération de photos nécessite plus de contrôle (texte dans l'image, JSON structuré avec hex/bbox, photoréalisme haute définition), utilisez `p-image-ideogram` (par défaut thinking: high, prompt_upsampling: true ; low + prompt_upsampling: false + prompt explicite pour un passage plus rapide sur le même modèle). Pour les retouches ou la vidéo, utilisez `p-image-edit` ou `p-video-2` — pas une nouvelle génération de photo.

Dans la première réponse, mentionnez `p-image` entre guillemets, confirmez que PRUNA_API_KEY est définie (ou arrêtez avec des liens d'inscription depuis pruna-api), puis demandez le prompt / le rapport d'aspect (ouverture de collecte → clarification de collecte generation-diversity). Lors de la rédaction du prompt, suivez Craft du prompt (dynamique + fidèle) — ne copiez pas les exemples de la compétence.

Craft du prompt (dynamique + fidèle)

Chaque input.prompt doit être frais et spécifique, et doit respecter la demande de l'utilisateur. La diversité ne remplace jamais le brief.

À faireÀ ne pas faire
Exécutez le rituel de seed aléatoire generation-diversity ; mentionnez-le ; faites varier ≥2 axes libres (appareil photo, éclairage, texture du décor, catégorie de rendu)Copiez des exemples curl de cette compétence (otter DJ, corgi cowboy, …) ou réutilisez un prompt d'une session précédente
Verrouillez d'abord les faits demandés par l'utilisateur (sujet, produit, indices de marque, accessoires à conserver, texte lisible si demandé)Remplacez le sujet par une scène "plus cool" qui ignore la demande
Enrichissez avec des noms concrets, une action figée, des matériaux, un placement (règles d'or de image-prompting)Chaînes vagues basées uniquement sur l'ambiance (cool product vibe, neon)
Montrez le prompt rédigé + aspect_ratio avant le POST si l'utilisateur n'a pas encore validé le wordingRe-générez en silence avec un sujet différent de celui approuvé

Vérification de fidélité (avant de payer) : si vous supprimez le sujet/produit/décor nommé par l'utilisateur du prompt, le travail est erroné — réécrivez. Les axes libres ne remplissent que ce que le brief a laissé ouvert.

Lors de la présentation d'un prompt rédigé, mentionnez toujours `p-image` (les guides aident à la rédaction ; c'est cet outil qui possède l'appel).

Note Pruna : p-image n'a pas de remontée de prompt — un langage concret est l'essence même du craft. Évitez la typographie dense et lisible sauf si l'utilisateur a explicitement demandé du texte sur une surface.

Quand NE PAS utiliser

Utilisez une autre compétence :

CompétenceDescriptionInstaller
p-image-ideogramÀ utiliser quand la génération de photos nécessite plus de contrôle — résultats photoréalistes, texte dans l'image, ou JSON structuré avec couleurs hex et boîtes englobantes. Les générations de photos plus simples, les retouches et la vidéo utilisent d'autres compétences de la suite.npx skills add PrunaAI/pruna-skills@p-image-ideogram -y
p-image-editÀ utiliser quand quelqu'un souhaite modifier une photo existante — changer les tenues ou les fonds, composer à partir d'images de référence, ou appliquer des retouches guidées par un prompt.npx skills add PrunaAI/pruna-skills@p-image-edit -y
p-image-try-onÀ utiliser quand quelqu'un souhaite un essayage virtuel — habiller une personne avec des vêtements à partir de photos de référence pour la mode ou l'e-commerce.npx skills add PrunaAI/pruna-skills@p-image-try-on -y

HTTP (curl)

Créer (asynchrone — recommandé)

curl -X POST 'https://api.pruna.ai/v1/predictions' \
  -H 'Content-Type: application/json' \
  -H "apikey: ${PRUNA_API_KEY}" \
  -H 'Model: p-image' \
  -d '{
    "input": {
      "prompt": "Reflets de boule à facettes sur une loutre DJ grattant un vinyle dans une patinoire bondée des années 1970, objectif fish-eye, confettis scintillants en suspension, énergie funky",
      "aspect_ratio": "9:16"
    }
  }'

Interrogez et téléchargez : suivez pruna-api.

Effectuez le rituel de seed aléatoire de generation-diversity avant d'écrire les prompts — ne passez pas la chaîne du rituel comme seed de l'API. api_seed optionnel seulement si l'utilisateur demande la reproductibilité.

Créer (synchrone — test rapide uniquement)

curl -X POST 'https://api.pruna.ai/v1/predictions' \
  -H 'Content-Type: application/json' \
  -H "apikey: ${PRUNA_API_KEY}" \
  -H 'Model: p-image' \
  -H 'Try-Sync: true' \
  -d '{"input":{"prompt":"Corgi cowboy lassant un camion à tacos en fuite dans une tempête de poussière à Monument Valley, énergie d\'affiche western pulp, composition diagonale dynamique","aspect_ratio":"16:9"}}'

Flux de génération

Suivez le flux de prompt d'image fixe de generation-diversity à chaque fois :

  1. Verrouiller le brief — sujet utilisateur, produit, format, tout texte sur surface.
  2. Seed rituel — chaîne fraîche ; dérivez les axes libres (appareil photo, éclairage, render_category_tag, aspect_ratio quand non défini).
  3. Rédiger un prompt explicite — Craft du prompt (dynamique + fidèle) + règles d'or de image-prompting ; vérification de fidélité avant de payer.
  4. Confirmer — montrez prompt + aspect_ratio sauf si le wording est verrouillé.
  5. POST — curl asynchrone ci-dessous ; interrogez via pruna-api ; exécutez la liste de contrôle qualité p-image avant upscale/vidéo.

Rapport d'aspect : passez aspect_ratio dans input ; si les dimensions de sortie ne correspondent pas (ex. demandé 16:9, obtenu portrait), réessayez une fois avec un wording explicite horizontal wide / vertical dans le prompt.

Mood board / lot : nouveau rituel par image indépendante ; aspect_ratio différent par panneau si le format n'est pas verrouillé.

Photo approuvée → retouche : passez à p-image-edit sur l'URL de sortie — ne relancez pas la génération photo pour le même sujet.

Entrée requise

  • prompt (string)

Champs optionnels courants

  • aspect_ratio : 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, custom (avec width / height multiples de 16, 256–1440)
  • seed, lora_weights, lora_scale, hf_api_token, disable_safety_checker

Prochaines étapes typiques

Suites courantes après cette compétence :

CompétenceDescriptionInstaller
p-image-editÀ utiliser quand quelqu'un souhaite modifier une photo existante — changer les tenues ou les fonds, composer à partir d'images de référence, ou appliquer des retouches guidées par un prompt.npx skills add PrunaAI/pruna-skills@p-image-edit -y
p-image-try-onÀ utiliser quand quelqu'un souhaite un essayage virtuel — habiller une personne avec des vêtements à partir de photos de référence pour la mode ou l'e-commerce.npx skills add PrunaAI/pruna-skills@p-image-try-on -y
p-image-upscaleÀ utiliser quand quelqu'un souhaite upscaler ou accentuer une image existante pour l'impression, des recadrages importants ou une livraison de meilleure qualité.npx skills add PrunaAI/pruna-skills@p-image-upscale -y
p-video-2-proÀ utiliser quand quelqu'un souhaite un clip cinématographique à partir de texte ou d'images de début/fin — publicités produit, plans documentaires ou dialogues avec audio généré. Pas pour 1080p, pistes audio importées ou présentateurs uniquement en plan poitrine.npx skills add PrunaAI/pruna-skills@p-video-2-pro -y
p-video-2À utiliser quand quelqu'un souhaite un court clip soigné à partir de texte, d'images ou d'audio importé — B-roll 1080p, animation d'images de début/fin, ou plan mouvementé avec piste mixte. Pas pour les clips audio générés cinématographiques ou les présentateurs uniquement en plan poitrine.npx skills add PrunaAI/pruna-skills@p-video-2 -y
p-videoÀ utiliser quand quelqu'un souhaite un court clip simple à partir de texte ou d'images — B-roll rapide, brouillons ou animation d'images de début/fin. Pas quand le brief nécessite une génération cinématographique, la plus haute qualité, un lip-sync serré ou un audio importé en 1080p.npx skills add PrunaAI/pruna-skills@p-video -y
avatar-single-sceneÀ utiliser quand quelqu'un souhaite un plan soigné d'un présentateur à l'écran — une personne qui parle avec des validations d'intention et de qualité avant la génération.npx skills add PrunaAI/pruna-skills@avatar-single-scene -y
avatar-multi-sceneÀ utiliser quand quelqu'un souhaite que la même personne anime plusieurs clips — contenu UGC multi-segments, bobines comparatives, ou scènes mixtes parlées et animées avec continuité.npx skills add PrunaAI/pruna-skills@avatar-multi-scene -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 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.

Skills associés