agentleFS
ohvignasohvignas/lancetonsite/skills/medias/SKILL.md

medias

Skill3 starsChanged 9 days agoMITView on GitHub

Produit tous les médias du site — photos, illustrations, vidéos de fond en boucle, sons, logo vectorisé — avec l''IA (MCP fal ou OpenRouter), comme sortis d''un même shooting, optimisés pour le web et rangés dans un manifeste. Étape 6 de Lance ton site.

  • Reads credentials
  • Installs packages

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈0

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Document présenté : le modèle ${CLAUDE_PLUGIN_ROOT}/commun/modeles/plan-medias.md, en entier : le plan médias avec la galerie des images …

    line 17

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Médias

Équipe d'agents : lancer ensemble, dès le début, tout ce que prévoit ${CLAUDE_PLUGIN_ROOT}/commun/agents.md pour cette étape (un agent Sonnet par source, page ou pièce indépendante).

Lire d'abord ${CLAUDE_PLUGIN_ROOT}/commun/conventions.md et ${CLAUDE_PLUGIN_ROOT}/commun/parcours.md (rythme, document publié, porte de validation, contrôle d'étape). Les générations partent en lot pendant qu'on écrit le reste. Document présenté : le modèle ${CLAUDE_PLUGIN_ROOT}/commun/modeles/plan-medias.md, en entier : le plan médias avec la galerie des images placées, jamais une image seule.

Entrées

  • 03-charte/charte.md — direction photo, palette (hex), ce qu'on ne montre jamais.
  • 04-architecture.md — les emplacements d'images page par page.
  • 05-contenus/ — ce que chaque image doit illustrer.
  • 04-wireframes/ — formats et ratios des emplacements d'image, page par page.
  • 00-etat.md — budget IA, et ligne « Médias fournis » (dossier de médias du client).

Sans direction photo dans la charte : la déduire de la charte et de la marque (references/fiche-shooting.md), marquée [hypothèse] dans le plan médias, sans question.

Règle d'or

Les vraies photos battent les photos IA pour tout ce qui doit inspirer confiance : l'équipe, le lieu, les vrais produits, les vrais clients. Commencer par ce que l'utilisateur a déjà fourni (ligne « Médias fournis » de 00-etat.md, sources/), sans nouvelle question : ce qui manque va dans la liste de prises de vue, et se dit à la porte. L'IA sert pour l'ambiance, les textures, les fonds, les illustrations, les plans impossibles à shooter. Ne jamais générer un faux client, un faux membre de l'équipe ou un faux témoignage visuel.

Pas de plafond de création : photos, objets détourés, textures, illustrations, vidéos, séquences d'images, objets 3D, sons — catalogue et outils dans ${CLAUDE_PLUGIN_ROOT}/commun/niveau-agence.md § 2 bis. Le coût est toujours annoncé avant et affiché après. Un dépassement du budget annoncé ne demande pas de oui : il s'annonce avec son coût, jamais en silence. Produire ce qui donnera du relief au site, pas seulement des photos.

Le site vise le niveau de ${CLAUDE_PLUGIN_ROOT}/commun/niveau-agence.md § 2 : hero en image ou vidéo plein cadre, au moins une grande image par page longue, rythme de tailles. Un site sans images ressemble à une ébauche.

Temps 1 — L'inventaire

D'abord, inventorier le dossier de la ligne « Médias fournis » de 00-etat.md (par exemple ./mes-videos/) : copier ces fichiers dans 06-medias/images/ ou 06-medias/videos/. Les vraies vidéos et photos passent avant toute génération et reçoivent les mêmes traitements que les générées (boucle, recadrage 9:16, affiche : voir temps 5). Rien de généré à la place d'un fichier fourni.

Dresser ensuite la liste de tous les médias nécessaires à partir de l'architecture, toutes les pages, secondaires comprises : emplacement, format, ratio, rôle, vraie photo disponible ou non. Y ajouter les déclinaisons pour les réseaux sociaux : une image de partage de 1200 × 630 px par page (images/partage-<page>.jpg) et l'image maîtresse en 1:1, recadrées depuis les images de la série. La publier en tableau dans le plan médias, tout de suite. Pour chaque ligne, choisir par défaut : vraie photo (si elle existe) / génération IA / image provisoire ; l'utilisateur corrige à la porte de validation. Le hero est une vidéo en boucle dès que le métier a un geste qui se filme.

Vraies photos pas encore reçues (cas fréquent) : pour chaque emplacement, écrire la liste de prises de vue (sujet, cadrage, lumière, horizontal ou vertical, 3 prises au moins), dire comment les envoyer (dossier 06-medias/a-recevoir/, ou dans la conversation) et générer en attendant (« Générer, par défaut »). Droit à l'image : accord écrit des personnes reconnaissables (parents pour un mineur), des équipes des lieux photographiés, et du photographe si ce n'est pas l'utilisateur. Le noter dans le manifeste.

Combien d'images (la source unique)

Le nombre de photos dépend de ce que la page doit faire ressentir. Compter sur le zoning de l'accueil (04-architecture.md) :

MétierPhotos sur l'accueil
Donner envie : événement, festival, ferme, restaurant, commerce, artisan, hôtel, lieudes photos dans la plupart des sections (au moins 3 sections sur 4), hero en vidéo ou en photos, les personnes et le lieu montrés ; jamais une seule photo pour tout le site
Rassurer : service local, profession libérale, B2Bune image par section au moins une fois sur deux : l'équipe, le lieu, les réalisations, le produit en usage
Montrer le produit : objet, logicielle produit dans chaque section (objet, interface vivante), plus 3 à 4 photos d'usage et de l'équipe

Le catalogue et les articles (architecture § 5) ont une photo par fiche et par carte : les compter dans l'inventaire.

Vidéos générées. Une vidéo générée rend une animation au défilement bien plus réaliste qu'une image fixe qui zoome : le geste du métier qui avance (data-video-scrub), une séquence d'images tirée d'une vidéo (data-sequence), une boucle de hero. Produire 1 à 3 vidéos dès que le métier a un geste, un lieu ou un objet qui bouge, avant d'ajouter des images fixes de plus. Budget à 0 : pas de génération (temps 2).

Plans et cartes. Un plan d'accès, une carte d'origine (« le blé pousse à 25 km du four »), un parcours, un plan de site : une illustration générée soignée, dans le style de la charte (image de référence : la palette, le logo, une photo du lieu), avec ses repères écrits en HTML par-dessus (une image générée n'a jamais de texte). Jamais un dessin SVG approximatif fait à la main. Les noms de lieux et les distances viennent du cadrage.

Générer, par défaut (la maquette n'attend pas)

La maquette ne montre jamais de rectangle vide ou hachuré. Toute image qui n'existe pas encore en vraie photo est générée, dans la direction photo, au bon ratio, comme un même shooting — c'est le parcours normal :

  1. Générer avec le générateur des conventions (« Quel générateur » : fal d'abord, OpenRouter ensuite), sur le budget IA unique : annoncer le lot et ce qui restera, sans attendre d'accord. Un dépassement s'annonce avec son coût. Générer l'image maîtresse, retenir la recommandée (temps 4), puis la série avec elle en référence. Deux chemins, mêmes prompts :
    • outils MCP : fal (run_model, submit_jobs) ou OpenRouter (generate-image) ;
    • script du kit de maquette generer-images.py (Claude Code) : --fal avec FAL_KEY, sinon OPENROUTER_API_KEY ; il lit les data-prompt des <img> de la page, génère tout, remplace les src.
  2. Banques libres seulement en repli (budget à 0, ou rien de connecté) : Unsplash, Pexels — chercher avec les mots de la direction photo (Firecrawl firecrawl_search, ou navigateur), choisir des images cohérentes entre elles, noter l'adresse et l'auteur. Licence Unsplash / Pexels : usage gratuit, pas de revente telle quelle.

Une image générée pour le lieu, le produit ou l'équipe reste une image provisoire tant que la vraie photo n'est pas là : on montre l'ambiance, pas une fausse réalité.

Chaque image qui tient la place d'une vraie photo est marquée provisoire dans le manifeste, et la maquette le dit en annotation hors de la page (« image générée en attendant ta photo : tes mains au tour »). Ne jamais présenter une image de banque comme le lieu, le produit ou l'équipe réels sur le site en ligne : à l'étape 11, toute image provisoire restante est signalée avant la mise en ligne.

Temps 2 — Le budget

Générateur : ${CLAUDE_PLUGIN_ROOT}/commun/conventions.md, « Quel générateur ». Budget : le budget IA unique fixé au démarrage (conventions, « Le budget de génération » ; ligne « Budget IA » de 00-etat.md). Estimer le coût du lot avant de lancer quoi que ce soit : estimate_cost / get_pricing sur fal ; sur OpenRouter, prix affiché sur la page du modèle (openrouter.ai/<modèle>). Tarifs indicatifs dans references/modeles.md. Annoncer : « environ X € pour N images et M vidéos, il restera Y € » — en euros (les tarifs sont en dollars : convertir, arrondir au-dessus). Dans le budget : lancer. Au-delà : annoncer le dépassement et son coût avant de lancer, sans attendre de oui, puis l'afficher ; jamais en silence. Après chaque lot : mettre à jour la ligne « Budget IA ». Plafond par défaut : 2 régénérations par média. Budget à 0 : banques libres en repli, et la liste de prises de vue.

Les temps 3, 4 et 6 concernent la génération. Sans génération : du temps 5, garder seulement le traitement des fichiers fournis (boucle, recadrage 9:16, affiche), puis passer au temps 7.

Vidéo : vérifier par une recherche web quels modèles vidéo sont les plus récents au moment du projet (Veo, Kling, Seedance, Runway… les noms changent vite) avant de recommander. Sans outil de génération : livrer le storyboard (plan par plan, 5 à 8 s) et les prompts complets prêts à lancer, et le dire.

Temps 3 — Le bloc de style et les détails de métier

Écrire un bloc de style en anglais, réutilisé mot pour mot dans chaque prompt : appareil et objectif, lumière, grain et rendu, palette avec codes hex, ce qu'on évite. Modèle et exemples : references/fiche-shooting.md.

Avant de générer, lister pour chaque scène 3 détails de métier vérifiables (tirés du cadrage et du questionnaire ; sinon déduits, marqués [hypothèse] dans le plan médias, sans question) : où sont les outils et dans quelle position, comment est éclairé l'atelier (lampes couchées, rasantes, au plafond…), quelle forme exacte a le produit. Les écrire en clair dans le prompt, puis les relire sur chaque image avant de la garder (voir « Erreurs de métier »).

Temps 4 — L'image maîtresse

Générer d'abord l'image la plus importante (souvent le hero) en 2 variantes, les montrer dans le plan médias dès qu'elles arrivent, retenir la recommandée et lancer la série aussitôt : pas de question à part (parcours.md § 1), l'utilisateur en change à la porte de validation. Cette image devient la référence de toutes les suivantes.

Temps 5 — La série

Chaque image suivante passe l'image maîtresse en référence (édition multi-références : image_urls sur fal, reference_image_urls sur le MCP OpenRouter). C'est ce qui donne un même shooting ; répéter le prompt ne suffit pas. Lancer les générations en lot (fal : submit_jobs, 8 travaux au plus par appel, à découper en lots, puis wait_for_jobs, show_media_batch ; OpenRouter : plusieurs generate-image en parallèle). Une image qui ne colle pas : la régénérer (2 fois max), sinon garder la meilleure et le signaler.

Référence déjà sur fal. L'image maîtresse sortie de fal a déjà une URL : la passer telle quelle dans image_urls, sans dépôt.

Référence locale sur fal. Le MCP fal ne lit pas les fichiers de l'ordinateur : une image de référence locale (maîtresse, logo) passe par un dépôt signé, en trois temps.

  1. upload_file avec prepare_upload: true, file_name et file_size en octets (stat -f%z hero.png sur macOS, stat -c%s hero.png sur Linux) : il rend une upload_url (privée) et une file_url.
  2. Envoyer le fichier : curl -sS --fail --upload-file hero.png "<upload_url>" (PUT).
  3. verify_upload avec file_url et file_size, puis passer file_url dans image_urls. Jamais l'upload_url.

JPEG ou PNG. Les modèles d'édition (nano-banana-2/edit) rendent tantôt du JPEG, tantôt du PNG, selon le lot. Nommer chaque fichier d'après son vrai format (file image.jpg le dit) et l'écrire tel quel dans le manifeste : .png et .jpg sont acceptés tous les deux, jusqu'à l'optimisation (temps 7).

Vidéos : plans de 5 à 8 s, lents, sans texte, muets. Dans l'ordre :

  1. La marque d'abord, sur l'image. Si le produit porte une marque (étiquette, logo, gravure), la poser sur l'image source avant la vidéo, comme une impression ou une lamination : retouche d'image avec le logo en image de référence (fal nano-banana-2/edit, OpenRouter generate-image avec reference_image_urls), ou composition (logo détouré calé en perspective, puis une passe de retouche pour la lumière). Vérifier l'image avant d'animer. Un logo posé en HTML par-dessus une vidéo glisse dès que la caméra bouge (niveau-agence.md § 2).
  2. La boucle : image de départ = image d'arrivée = cette image marquée. Sur fal (Kling) : start_image_url et end_image_url (tail_image_url sur les anciennes versions : vérifier avec get_model_schema), generate_audio à false. Sur OpenRouter : first_frame_image_url = last_frame_image_url, generate_audio à false. Une vidéo prend 1 à 5 minutes : sur OpenRouter, appeler get-video toutes les 15-20 s jusqu'à completed, puis télécharger aussitôt (lien valable environ 24 h). La force du mouvement : un prompt trop sage donne une boucle qui paraît figée (test réel : 4 min 40 s et 1,34 $ pour la refaire). Demander un mouvement franc, dans toute l'image, en plus de la caméra fixe : « strong steady wind moves the leaves and the hanging cloth across the whole frame, clearly visible motion in every part of the image, locked-off camera ». Essayer une vidéo, la contrôler avec captures.py --hero (moins de 1 % de pixels qui changent : refaire le prompt), puis lancer les autres.
  3. Le zoom parasite : les modèles vidéo poussent souvent la caméra malgré « static camera, locked-off shot ». Comparer la première et la dernière image ; si la boucle saute, la recoudre avec un fondu enchaîné de 0,5 s entre la fin et le début : D=$(ffprobe -v error -show_entries format=duration -of csv=p=0 v.mp4); C=$(echo "$D - 0.5" | bc), puis ffmpeg -i v.mp4 -filter_complex "[0]split[a][b];[a]trim=0:$C,setpts=PTS-STARTPTS[x];[b]trim=$C,setpts=PTS-STARTPTS[y];[y][x]xfade=transition=fade:duration=0.5:offset=0" -an boucle.mp4. Mise à l'échelle : l'ajouter dans ce filtre (…offset=0,scale=1280:-2), -vf et -filter_complex ne se combinent pas. Sinon régénérer une fois.
  4. Le recadrage mobile : le hero a sa version 9:16, centrée sur le sujet (le produit, pas le ciel) : ffmpeg -i hero.mp4 -vf "crop=ih*9/16:ih:(iw-ih*9/16)*0.5:0,scale='min(1080,iw)':-2" -an hero-916.mp4 (remplacer 0.5 par la position horizontale du sujet, de 0 à 1), et son affiche recadrée de même. Sur la page : <source media="(max-width: 767px)">.
  5. Toujours une image d'affiche (poster) par vidéo et par format.

Objets 3D : skill objets-3d (Blender par script, d'abord). L'appeler dès qu'un objet sert l'histoire (produit, contenant, outil). Il fait les photos produit du catalogue, les séquences d'animation et le .glb, avec sa propre boucle de correction et sa porte de validation. Objet qui porte une marque : modélisé dans Blender, jamais généré ; objet générique : bibliothèque libre (Poly Haven…) ou, en appoint payant, image → 3D. L'animation finit sur la face avant, logo visible. Règles complètes : niveau-agence.md § 2 bis, « 3D et marquage » et « 3D : la fin de l'animation ». Ranger les GLB dans 06-medias/3d/.

Sons : dès qu'ils servent la marque, notés dans l'inventaire, coupés par défaut côté site. Sans fal, pas de génération de sons : livrer les prompts.

Temps 6 — Les outils, dans l'ordre

L'ordre est celui des conventions (« Quel générateur ») :

  1. MCP fal, s'il est connecté : recommend_model → run_model ou submit_job → check_job → show_media → save_job_outputs pour télécharger.
  2. Sinon MCP OpenRouter (sans redemander) :
    • images : generate-image (model, prompt, aspect_ratio, reference_image_urls) ;
    • vidéos : generate-video (model, prompt, duration, aspect_ratio, resolution, first_frame_image_url / last_frame_image_url) puis get-video jusqu'à completed ;
    • coût réel dépensé : get-session-cost ;
    • pour des lots ou en script : scripts/openrouter-image.sh (variable OPENROUTER_API_KEY).
  3. Rien de connecté : le signaler à la porte (OpenRouter donne images et vidéos en une connexion), prendre les banques libres en repli, et livrer pour chaque emplacement le prompt complet, le ratio et le modèle conseillé, prêts à coller.

Temps 7 — Optimiser pour le web

Lancer bash ${CLAUDE_SKILL_DIR}/scripts/optimiser-medias.sh projet-site/06-medias projet-site/06-medias/web (c'est le script de cette étape ; il parcourt images/, videos/, 3d/…) : AVIF + WebP en 640/1024/1600/2560 px et toujours à la largeur d'origine (une source de 928 px sort en 640 et 928, pour les écrans 2×), vidéos H.264 + WebM sans son, poster JPG, modèles GLB compressés (Draco, avec npx @gltf-transform/cli si npx est là). Cible : hero < 250 Ko en AVIF, vidéo de fond < 3 Mo, GLB 500 Ko (plafond 3 Mo : au-delà, alléger le modèle). Les .glb ont un seul chemin source, 06-medias/3d/, et sont copiés dans site/modeles/ à la construction. Générer les images à 2K quand le modèle le permet : une source de 1K est trop petite pour un hero. Le script accepte .png, .jpg, .jpeg et .webp, et signale un fichier dont le contenu ne correspond pas à l'extension. Le script demande ffmpeg. Absent : le signaler (brew install ffmpeg sur macOS, sudo apt install ffmpeg sur Ubuntu ; dans Claude, ne pas l'installer), et faire avec Pillow : python3 ${CLAUDE_PLUGIN_ROOT}/commun/scripts/optimiser-images.py projet-site/06-medias/images projet-site/06-medias/web (WebP en 1600 et 800 px, pip install pillow s'il manque). Ce repli ne lit pas les sous-dossiers et ne traite ni vidéos ni modèles 3D : ils restent en originaux, notés dans le manifeste, et s'optimisent à l'étape 11. La maquette utilise les originaux.

Encodage sur macOS en bac à sable. sips ne peut pas y écrire son fichier temporaire, et le ffmpeg du système n'a souvent ni libwebp ni libaom : seule la chaîne ffmpeg → PNG → cwebp / avifenc marche. Le script la prend d'abord ; s'il annonce « WebP ignoré » ou « AVIF ignoré », le signaler (brew install webp libavif) ; si aucune image n'a été convertie, passer au repli Pillow. Ne pas utiliser sips.

Temps 8 — Le manifeste

Écrire projet-site/06-medias/medias.md avec templates/medias.md : original, emplacement, rôle, format, affiche, statut (provisoire / définitif), texte alternatif, modèle, prompt, référence utilisée, coût, origine (IA / photo ou vidéo fournie / banque libre avec licence). Le texte alternatif décrit le contenu et sa fonction en 125 caractères max ; alt="" pour une image purement décorative.

Garde-fous

  • Jamais de texte, de logo inventé ni de filigrane dans une image générée.
  • Jamais le visage d'une personne réelle identifiable, ni une marque déposée.
  • Mentionner dans le manifeste les médias générés par IA ; si le site montre des personnes générées, le dire à l'utilisateur et lui conseiller de l'indiquer.
  • Erreurs de métier : relire chaque image avec l'œil du client expert, en commençant par les 3 détails de métier listés au temps 3. Le bon outil au bon endroit, le geste juste, la machine plausible, l'éclairage du lieu tel qu'il est vraiment, la forme exacte du produit, l'écran qui affiche ce que dit le texte. Un professionnel repère une erreur en trois secondes, et toute la page perd sa crédibilité. Une image fausse se régénère avec une consigne précise (« capteur fixé sur le carter du palier, pas sur l'arbre ») ; un écran de téléphone ou d'ordinateur s'affiche en HTML par-dessus, jamais en texte généré.

Avant la porte

Cocher d'après les fichiers, en ouvrant les images. Un manque se fait maintenant.

  • 06-medias/medias.md suit le modèle : intention, livrables, fixé et libre, bloc de style (s'il y a génération), liste de plans, vidéo (s'il y en a une), contrôle de cohérence, manifeste, budget.
  • Chaque emplacement de 04-architecture.md et de 04-wireframes/ a sa ligne, pages secondaires, fiches et cartes comprises. Le nombre de photos de l'accueil tient le tableau « Combien d'images ». Chaque page a son image de partage.
  • Chaque ligne du manifeste correspond à un fichier présent dans 06-medias/ (images/, videos/, 3d/) et porte sa page, son rôle, son format, son statut, son origine, son texte alternatif de 125 caractères au plus. Chaque image générée a son modèle, son prompt, sa référence et son coût.
  • Tous les fichiers de la ligne « Médias fournis » sont copiés et inventoriés. Aucune génération à leur place.
  • Le hero a ses deux formats, bureau et mobile. Chaque vidéo : boucle sans saut, muette, version 9:16 pour le hero, une affiche par format, contrôlée avec captures.py --hero.
  • Chaque vraie photo manquante a sa liste de prises de vue (3 prises au moins), son image provisoire et son droit à l'image noté.
  • Chaque image relue : les 3 détails de métier sont justes ; même lumière, même grain, même palette ; rien qui fasse « image de banque » ou « rendu 3D lisse » ; aucun texte, faux logo ou filigrane. Le contrôle de cohérence est coché.
  • 06-medias/web/ contient les versions web, poids mesurés : hero sous 250 Ko, vidéo de fond sous 3 Mo, GLB à 500 Ko (plafond 3 Mo). Sans ffmpeg : le signalement est fait, les images sont en WebP, et vidéos et GLB sont notés pour l'étape 11.
  • Objets 3D, s'il y en a : boucle passée (06-medias/3d/boucle/), rendus finaux validés, lignes au manifeste.
  • La ligne « Budget IA » de 00-etat.md porte le coût réel. Tout dépassement y est affiché.

Puis le contrôle d'étape : ${CLAUDE_PLUGIN_ROOT}/commun/boucle-persona.md, « Le contrôle d'étape ».

Ensuite, publier le plan médias (parcours.md § 3) : l'inventaire, le bloc de style et la galerie des images à leur emplacement (rôle, texte alternatif, provisoire ou non). Puis porte de validation (parcours.md § 4) : jamais la maquette sans un oui. 00-etat.md et tableau de bord à jour. Prochaine étape : /lancetonsite:maquette — le site dessiné sur le canevas Claude Design et en version animée, avec ces médias.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.