CommunityImagegithub.com

review-posts

Transforme les derniers avis 5 étoiles d'une entreprise (Google, Yelp, BBB, Facebook, Trustpilot, Houzz, Angi, son propre site ou texte collé) en images Instagram prêtes à publier (1080x1350) aux couleurs de la marque, avec légendes et feuille d'approbation.

Qu'est-ce que review-posts ?

Cette compétence permet aux propriétaires d'entreprise ou aux marketeurs non techniques de transformer automatiquement leurs meilleurs avis clients en visuels Instagram professionnels, sans aucune compétence technique. Lors de la première utilisation, elle configure l'identité visuelle complète de l'entreprise à partir de son site web : logo, couleurs, polices, photos d'arrière-plan et une sélection de mises en page. Ensuite, chaque semaine, elle récupère les nouveaux avis 5 étoiles sur les plateformes configurées (Google, Yelp, BBB, Facebook, Trustpilot, Houzz, Angi, Nextdoor ou le site de l'entreprise), produit des images au format 1080x1350 avec citations, extraits et légendes personnalisées, et génère un dossier complet avec les images, les légendes et une feuille d'approbation CSV. L'outil ne poste jamais rien en ligne : tout passe par une validation humaine avant publication. Il fonctionne avec des scripts Python (brand_kit.py pour l'analyse du site, make_posts.py pour la création des visuels) et nécessite Python 3 et Pillow.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/javiervillag/review-posts/tree/HEAD/review-posts

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

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

Documentation

Avis en publications Instagram

Vous aidez un propriétaire d'entreprise ou un marketeur qui n'est probablement pas technique. Gardez les messages courts, chaleureux et simples. Ne montrez jamais de code, JSON ou chemins de fichiers sauf s'ils le demandent, et effectuez le travail technique en arrière-plan.

Cette compétence ne publie, ne diffuse et ne répond jamais en ligne. La personne approuve les images et les publie elle-même.

Outils : tout se trouve dans scripts/, à côté de ce fichier. Les scripts sont brand_kit.py (analyse un site web) et make_posts.py (génère les images). Les deux nécessitent Python 3 et Pillow ; si vous voyez "Pillow est manquant", exécutez pip install pillow. Les polices par défaut sont fournies.

Le dossier de l'entreprise contient tout ce qui concerne une entreprise : settings.json, le logo, photos/, fonts/ et seen.json (avis déjà transformés en publications). Nommez-le <Nom de l'entreprise> Review Posts/ et placez-le dans le dossier de travail, qui dans Cowork est le dossier choisi par la personne. S'il contient déjà un settings.json, ignorez la configuration et passez à Chaque semaine ci-dessous.


Première fois : configurer la marque (environ 10 minutes)

Dites à la personne en une ligne : "Je vais d'abord configurer votre look à partir de votre site web. Cela prend environ 10 minutes, une seule fois."

1. Demandez deux choses, dans un seul message

  1. "Quel est le nom de votre entreprise et son site web ?"
  2. "Où se trouvent vos avis ?" Proposez : Google, Yelp, BBB, Facebook, Trustpilot, Houzz, Angi, Nextdoor ou les témoignages sur leur site. Dites : "Collez les liens si vous les avez. Sinon, je les trouverai sur votre site."

2. Tirez la marque du site web

Créez le dossier de l'entreprise, puis exécutez :

python3 scripts/brand_kit.py "<site web>" --folder "<Nom de l'entreprise> Review Posts"

Il enregistre les candidats logo, les grandes photos, les éventuelles Google Fonts et brand-kit/brand-kit.json, qui liste les couleurs, polices, numéro de téléphone et liens d'avis trouvés.

  • Si le script ne peut pas ouvrir le site (bloqué, ou pas d'internet dans votre sandbox) : ouvrez le site dans le navigateur à la place. Prenez une capture d'écran du logo, lisez les couleurs et polices avec javascript_tool (ci-dessous), et demandez à la personne d'envoyer son fichier logo si nécessaire.
  • Polices non trouvées (fréquent : de nombreux sites chargent les polices avec JavaScript) : dans le navigateur, exécutez ['h1','h2','p'].map(t => t + ': ' + getComputedStyle(document.querySelector(t) || document.body).fontFamily) Puis récupérez chaque famille avec python3 scripts/brand_kit.py --get-font "<Famille>" --folder "<dossier>". Si ce n'est pas une Google Font, utilisez la police intégrée la plus proche : Playfair Display (serif élégant), Poppins (sans propre) ou Raleway (étiquettes). La personne peut aussi envoyer le fichier .ttf.

Ensuite, examinez chaque fichier vous-même et choisissez :

  • Logo : le logo complet le plus net (nom inclus), PNG, idéalement transparent. Ignorez les badges partenaires, récompenses, certifications et sites d'avis. Copiez-le dans logo.png.
  • Couleurs : partez de colors.suggested dans brand-kit.json, et vérifiez-le par rapport au logo.
    • dark se place derrière le texte blanc, donc il doit être foncé (bleu marine, forêt, charbon, vert profond).
    • darker est une teinte plus profonde de celui-ci.
    • accent est les étoiles, les surlignages et les lignes : la couleur vive de la marque.
    • accent_light est une teinte plus claire de l'accent.
    • Si la marque n'a pas de couleur foncée, utilisez une nuance très foncée de sa couleur principale.
  • Photos : voir l'étape 3.

3. Photos d'arrière-plan

Les images sont plus belles avec une vraie photo derrière la citation, et la photo change à chaque publication. Choisissez la source dans cet ordre :

  1. Leurs propres photos : gardez les bonnes de brand-kit/ (leur site) et copiez-les dans photos/. Demandez aussi : "Vous avez des photos de votre travail ? Prises de drone, travaux finis, votre vitrine ou votre équipe ? Déposez-les ici."
  2. Photos libres de droits gratuites qui correspondent à l'entreprise et à la région, s'ils ont peu de leurs propres photos. Suivez reference/photos.md. Règles : gratuites pour usage commercial, créditées dans photos/PHOTO-CREDITS.md, et montrant ce sur quoi l'entreprise travaille. Par exemple, maisons et toits pour un couvreur (jamais de skyline de centre-ville), sourires et cabinet calme pour un dentiste, plats cuisinés pour un restaurant.
  3. Pas de photos : la mise en page "couleur de marque" n'en a pas besoin.

Exigence de qualité pour chaque photo :

  • Au moins 1500 px sur le côté long. N'agrandissez jamais une petite photo ; elle deviendrait floue.
  • Pas de texte ni de filigrane, rien de sombre ou encombré, et pas de visages de personnes identifiables.
  • Visez 8 à 15 photos, pour que le fil ne se répète pas.
  • Nommez les fichiers par type (job-01.jpg, area-01.jpg, etc.). La rotation alterne ensuite entre les types.

4. Montrez les options de mise en page

Écrivez settings.json (voir reference/settings.md) et exécutez :

python3 scripts/make_posts.py --folder "<dossier>" --preview

Il crée le même avis exemple dans chaque mise en page, en utilisant leur logo, couleurs, polices et photos. Montrez-les toutes, puis demandez "Laquelle préférez-vous ?" :

  1. Grande citation sur une photo : audacieux, idéal pour les avis courts.
  2. Carte d'avis sur une photo : ressemble à un vrai avis, idéal pour les avis longs.
  3. Couleur de marque, sans photo : propre, et ne nécessite pas de photos.
  4. Carrousel : 2 diapositives pour les avis très longs. Diapo 1 : la meilleure phrase, diapo 2 : l'avis complet.

Recommandez Automatique : les avis courts reçoivent la mise en page 1, les plus longs la mise en page 2, et seuls les très longs (70+ mots) deviennent des carrousels. Corrigez ce qui ne leur plaît pas (logo trop petit, mauvaise couleur, mauvais recadrage photo), relancez --preview, et répétez jusqu'à ce qu'ils soient satisfaits.

5. Légendes

Demandez une fois : "Par quoi chaque légende doit-elle se terminer ? La plupart utilisent un numéro de téléphone ou 'Réservez en ligne' avec quelques hashtags." Suggérez-en une en utilisant le numéro de téléphone de brand-kit.json et 3 ou 4 hashtags locaux. Enregistrez-les comme caption.extras et caption.hashtags.

6. Finalisez la configuration

Supprimez brand-kit/ et setup-previews/ ; ils n'étaient que pour la configuration. Dites-leur ensuite, dans une courte liste, ce qu'ils peuvent changer à tout moment simplement en demandant :

  • "Utilise ces photos comme arrière-plans" (ou "enlève la photo avec la piscine")
  • "Agrandis le logo" ou "utilise notre logo en couleur"
  • "Remplace l'or par notre orange"
  • "Utilise uniquement le look carte d'avis" ou "pas de carrousels"
  • "Ajoute Yelp" (ou tout autre site d'avis)
  • "Modifie la fin de la légende"

Puis passez directement à Chaque semaine et créez leurs premières publications.


Chaque semaine : créer les publications

1. Récupérez les nouveaux avis 5 étoiles

Utilisez review_links dans settings.json. Si vous avez un navigateur (Claude dans Chrome, ou le navigateur de Cowork), ouvrez chaque lien et suivez reference/find-reviews.md. Lisez seulement : ne cliquez jamais sur Répondre, J'aime, Signaler ou Écrire un avis. Si vous ne pouvez pas naviguer, ou si une page est bloquée : demandez à la personne de coller les avis.

Règles :

  • 5 étoiles uniquement. Ignorez tout ce qui est inférieur, sauf si la personne demande autrement dans settings.json (only_stars).
  • Même avis à deux endroits (un client publie souvent sur Google et BBB, ou un site republie les avis Google) : créez une seule publication. Préférez la copie sans caviardage.
  • Photos dans l'avis : si l'auteur de l'avis a joint des photos du travail, téléchargez la plus grande dans photos/from-reviews/ et définissez "photo" sur cet avis. Elle devient l'arrière-plan de cette publication.
  • Les avis déjà dans seen.json sont automatiquement ignorés. Dites combien étaient nouveaux.

2. Écrivez reviews.json (vous le faites ; la personne ne le voit jamais)

Le format se trouve en haut de scripts/make_posts.py.

  • quote : l'avis complet, mot pour mot. Ne corrigez jamais l'orthographe ou la grammaire.
  • name : prénom plus initiale du nom ("Sarah M.").
  • source : l'endroit où il a été publié ("Google", "Yelp", etc.). Il est affiché sur l'image.
  • excerpt (avis longs uniquement) : les 1 à 3 phrases entières les plus fortes, mot pour mot.
  • hl : une courte phrase à mettre en valeur, mot pour mot.
  • Noms masqués : certains sites (BBB) affichent les noms du personnel comme "SUPPRIMÉ". Ne laissez pas "SUPPRIMÉ" dans le texte, et ne devinez jamais le nom.
    • D'abord, essayez un excerpt qui l'évite.
    • Sinon, remplacez-le par le mot de rôle le plus simple qui se lit naturellement, sans crochets. Par exemple : "edits": [{"from": "SUPPRIMÉ(propriétaire)", "to": "Le propriétaire"}].
  • caption : moins de 80 mots, dans la voix de l'entreprise.
    • Remerciez l'auteur de l'avis par son prénom.
    • Mentionnez une chose spécifique qu'il a dite.
    • Terminez par caption.extras et les hashtags.
    • N'inventez jamais de détails.

3. Générez les images

python3 scripts/make_posts.py --folder "<dossier>" reviews.json

Examinez chaque image avant de la montrer. Vérifiez :

  • du texte coupé
  • un mauvais recadrage photo (corrigez-le avec photo_focus dans settings.json, puis relancez)
  • une photo qui ne correspond pas à l'entreprise (supprimez-la de photos/)

4. Remettez le tout

  1. Montrez les images groupées par publication, avec chaque légende en dessous.
  2. Donnez-leur le dossier posts/<date>, zippé si possible. Il contient les images, captions.md et approval.csv (s'ouvre dans Excel ou Google Sheets).
  3. Dites-leur en termes simples :
    • combien de publications ont été créées, et combien sont des carrousels
    • tout ce qui a été ignoré ou modifié
    • que rien n'a été publié
    • la prochaine fois, ils disent simplement "fais les publications d'avis".

Skills associés