Communitygithub.com

Koubou : Générateur de captures d'écran App Store

Générez des captures d'écran professionnelles pour l'App Store à l'aide de modèles HTML/CSS avec des cadres d'appareils réels. Crée des captures localisées pour iPhone, iPad, Mac et Apple Watch. À utiliser lorsque l'utilisateur souhaite créer, concevoir ou mettre à jour des captures d'écran pour l'App Store.

Qu'est-ce que Koubou : Générateur de captures d'écran App Store ?

Koubou est un outil spécialisé conçu pour générer des captures d'écran professionnelles pour l'App Store en utilisant des modèles HTML/CSS. Il prend en charge plus de 100 cadres d'appareils réels, la localisation via xcstrings et des dimensions Apple pixel-perfect. L'outil fonctionne comme une compétence pour les agents IA (tels que Claude Code) et nécessite que l'agent inspecte d'abord le langage visuel de l'application avant de poser des questions de style. Le processus inclut des phases de configuration silencieuse, de découverte de style, d'entretien d'intention réduit et de génération de modèles avec des règles strictes de qualité. L'outil garantit que chaque capture raconte une histoire marketing cohérente, évite les mises en page génériques et respecte des contraintes de lisibilité, d'échelle et de variété. Il fournit des mécanismes de post-rendu QA, y compris l'inspection des fichiers JSON de mise en page et l'application de tests comme le 'logo-swap test' pour éviter les designs trop génériques. Koubou est idéal pour les développeurs et les spécialistes du marketing souhaitant créer rapidement des campagnes de captures d'écran professionnelles et localisées sans conception manuelle fastidieuse.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bitomule/Koubou/tree/HEAD/skills/koubou

Demander à votre IA préférée

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

Documentation

Que fait Koubou : Générateur de captures d'écran App Store ?

Générez des captures d'écran professionnelles pour l'App Store à l'aide de modèles HTML/CSS avec plus de 100 cadres d'appareils réels, une localisation xcstrings et des dimensions Apple pixel-perfect.

Les captures d'écran sont des publicités, pas de la documentation. Chaque diapositive vend un sentiment, un résultat ou une solution à un problème.

Les instructions de l'utilisateur prévalent toujours sur les valeurs par défaut de cette compétence.

La direction créative est ouverte par défaut. Utilisez les règles de cette compétence pour imposer l'impact, la lisibilité et l'échelle adaptée au canevas, pas pour donner le même aspect à tous les ensembles.

Hiérarchie des règles

Traitez les directives de cette compétence dans cet ordre :

  1. Contraintes strictes — lisibilité, échelle, clarté des miniatures, marketing produit véridique et conscience réelle du canevas
  2. Valeurs par défaut fortes — variété, asymétrie, chevauchement, rythme et évitement des mises en page génériques
  3. Préférences de goût — heuristiques anti-banalité et valeurs par défaut stylistiques qui peuvent être enfreintes lorsqu'une idée plus forte améliore clairement le travail

Si enfreindre une valeur par défaut produit un meilleur ensemble de captures, enfreignez-la délibérément et expliquez le compromis à vous-même avant de générer.

Fichiers de référence (à lire selon les besoins, pas à l'avance) :

  • setup.md — Installation et configuration du runtime HTML
  • design-guide.md — Principes de conception, règles de rédaction, règles CSS, exemples de modèles HTML
  • style-intake.md — Comment inspecter le langage visuel réel de l'application avant de poser des questions
  • style-interview.md — Questions de style courtes et à fort signal et modèles de conversation
  • yaml-reference.md — Format de configuration YAML, localisation, ressources, appareils, tailles
  • capabilities-reference.md — Capacités complètes de koubou (mode de contenu, points forts, zoom, dégradés)

Phase 1 : Configuration (silencieuse, automatique)

Vérifiez d'abord si kou est disponible. Ne réinstallez pas et ne touchez pas à l'empaquetage Python si kou fonctionne déjà.

Ordre préféré :

kou --version 2>/dev/null

Si kou --version réussit :

  • considérez koubou comme installé
  • ne lancez pas pip, pip3 ou playwright install
  • ne tentez pas de « mettre à niveau » ou de « réparer » l'environnement de l'utilisateur de manière proactive
  • exécutez toujours kou setup-html avant de générer, car cette compétence est exclusivement HTML et la commande est conçue pour être répétée sans risque

Si kou --version échoue, lisez setup.md et suivez le chemin le moins invasif pour l'environnement.

Pour la prise en charge du rendu HTML :

  • utilisez toujours kou setup-html
  • ne sautez pas cette étape simplement parce que HTML a fonctionné lors d'une exécution précédente
  • ne lancez pas playwright install chromium directement

Informez l'utilisateur uniquement si la configuration échoue. Ne modifiez jamais une installation fonctionnelle.

Phase 2 : Lire l'application, puis demander

Ne commencez pas par un questionnaire de style générique. Inspectez d'abord le langage visuel réel de l'application, puis ne demandez que ce qui manque encore ou est ambigu.

Lisez style-intake.md avant de poser des questions de style. Suivez cet ordre.

2.1 Découverte de style (obligatoire avant les questions de style)

Inspectez d'abord les sources du projet local. Recherchez automatiquement avant de demander une direction visuelle à l'utilisateur.

Priorisez ces sources :

  1. Assets.xcassets, icônes d'application, illustrations, logos, ressources de couleur
  2. Dossiers de captures d'écran et marketing existants :
    • .maestro/
    • screenshots/
    • AppStore/
    • fastlane/screenshots/
    • marketing/
  3. Documentation produit et positionnement :
    • README*
    • CLAUDE.md
    • plans de lancement, copie de page d'accueil, dossiers de documentation
  4. Jetons de conception et code UI :
    • Variables CSS
    • Couleurs SwiftUI, dégradés, matériaux, choix typographiques
    • fichiers de thème web et constantes de conception partagées
  5. Artefacts App Store antérieurs s'ils existent :
    • modèles précédents
    • anciennes campagnes de captures
    • ressources marketing localisées

Extrayez et résumez au moins ces signaux :

  • couleurs dominantes et couleurs d'accentuation
  • contraste global : sombre, clair, mixte, atténué, vif
  • densité UI : aérée, équilibrée, dense
  • langage des formes : net, doux, arrondi, riche en cartes, plat
  • style d'iconographie et d'illustration
  • direction typographique si visible
  • ton de la copie : calme, technique, ludique, premium, chaleureux, urgent
  • si l'application semble calme, technique, chaleureuse, énergique, soignée, ludique, etc.

Si le style de l'application est clair :

  • résumez les signaux détectés à l'utilisateur en langage clair
  • confirmez que vous allez construire à partir de cette direction au lieu de repartir d'un langage de modèle générique

Si les signaux sont faibles, manquants ou contradictoires :

  • dites ce que vous avez trouvé
  • posez des questions de suivi ciblées sur l'incertitude au lieu de poser un questionnaire de conception large

2.2 Entretien d'intention (court, à fort signal)

Lisez style-interview.md et ne demandez que le strict minimum. Restez conversationnel. Ne déversez pas toutes les questions à la fois.

Questions de style requises si encore nécessaires :

  1. Quel sentiment la campagne doit-elle projeter : premium, ludique, éditorial, utilitaire, technique, chaleureux, etc. ?
  2. Y a-t-il des références App Store, des marques ou des ensembles de captures qui devraient influencer la direction ?
  3. Qu'est-ce qui est visuellement interdit : dégradés forts, glassmorphisme, sombre uniquement, grilles de cartes, style trop ludique, etc. ?
  4. Quel trait visuel de l'application elle-même doit encore être reconnaissable dans les captures ?

Questions facultatives uniquement si encore non résolues :

  1. Direction typographique préférée ou personnalité de police
  2. Biais clair, sombre ou mixte
  3. Préférence de densité : plus d'air ou plus d'informations
  4. Si l'ensemble doit sembler strictement cohérent ou visiblement varié entre les diapositives

2.3 Informations produit (toujours requises)

Après le début de la découverte de style, collectez naturellement les entrées de production restantes :

  1. Application : Nom, ce qu'elle fait (1 phrase), proposition de valeur principale
  2. Captures d'écran : Où se trouvent les captures de l'application ? Recherchez automatiquement d'abord :
    • Si trouvé, montrez ce que vous avez trouvé et confirmez
    • Si non trouvé, demandez comment l'utilisateur les génère
    • Préférez les captures de simulateur propres qui montrent clairement l'UI de l'application. Si l'utilisateur peut choisir, préférez les captures iPhone 6,1 pouces récentes comme matériel source
  3. Fonctionnalités à mettre en avant : Liste priorisée des fonctionnalités/avantages (recommander 3 à 5). Chaque diapositive = 1 fonctionnalité
  4. Ressources hero : Icône de l'application ou autre ressource de marque. Recherchez automatiquement avant de demander
  5. Nombre de diapositives : Combien de captures d'écran (recommander 3 à 5 pour commencer, Apple autorise jusqu'à 10)

Facultatif uniquement si pertinent :

  1. Appareil : Par défaut, iPhone 16 Pro - Black Titanium - Portrait. Demandez uniquement si iPad/Mac/autre a du sens
  2. Localisation : Uniquement si le projet a déjà des xcstrings ou une prise en charge multilingue
  3. Ressources supplémentaires : Éléments UI flottants, badges, illustrations de support
  4. Contraintes supplémentaires : Réclamations requises, styles interdits ou contraintes marketing

2.4 Décision de style (obligatoire avant le HTML)

Avant de rédiger les modèles, décidez et verrouillez explicitement ces six éléments :

  • signaux de marque détectés
  • style de campagne choisi
  • voix de la copie
  • système d'arrière-plan
  • rythme de composition de l'appareil
  • plan de variation entre les diapositives

Chaque élément doit être justifié soit par :

  • des preuves de l'application issues de la découverte de style, ou
  • un retour direct de l'utilisateur lors de l'entretien

Si vous ne pouvez pas justifier l'un d'eux, continuez à poser des questions ciblées avant de concevoir.

Dérivé (NE PAS demander sauf si bloqué)

  • Dégradés ou textures d'arrière-plan à partir des couleurs de la marque et de l'ambiance UI
  • Répartition de la mise en page (hero → fonctionnalité-haut → fonctionnalité-bas → alternance)
  • Copie du titre à partir des fonctionnalités et de la proposition de valeur
  • Palette secondaire à partir de la palette réelle de l'application
  • Classe de canevas à partir de project.device + project.output_size via kou inspect-frame
  • Si le nom de l'application doit apparaître ou non. Par défaut : omettez-le sauf s'il ajoute une réelle valeur de marque à une taille lisible
  • Si l'icône de l'application doit apparaître. Par défaut : utilisez-la avec parcimonie sur les diapositives hero ou de clôture, pas comme un petit élément décoratif

Principe : si le contexte est disponible localement, utilisez-le avant de demander. Les questions de style viennent après l'inspection, pas avant.

Phase 3 : Générer

Lisez design-guide.md avant de générer les modèles. Lisez yaml-reference.md avant d'écrire la configuration.

  1. Créez un répertoire de travail (par exemple, AppStore/ ou là où cela a du sens pour le projet)

  2. Exécutez kou setup-html

  3. Lisez project.device et project.output_size à partir du YAML

  4. Exécutez kou inspect-frame "<appareil>" --output-size <taille> --output json et utilisez cette géométrie avant d'écrire le CSS

  5. Rédigez l'arc narratif et 2 à 3 options de titre/sous-titre par diapositive avant de toucher à la mise en page. Choisissez d'abord le plus fort. La qualité de la copie passe avant le CSS

  6. Traduisez la décision de style en un brief de campagne :

    • ce que l'ensemble doit ressembler
    • quels motifs sont autorisés
    • quels motifs sont interdits
    • combien de variation les 5 premières diapositives doivent montrer
  7. Créez templates/ avec des modèles HTML — au moins 3 mises en page distinctes, et les 3 premières diapositives ne doivent pas répéter le même archétype de composition

  8. Dans chaque modèle HTML, ajoutez data-kou-id et data-kou-role à ces éléments avant d'écrire du CSS :

    • Titre principal : data-kou-id="headline" data-kou-role="headline"
    • Copie de support : data-kou-id="subtitle" data-kou-role="supporting"
    • Image de l'appareil principal : data-kou-id="device" data-kou-role="device"
    • Titres/sous-titres de fonctionnalités (diapositives de clôture/fonctionnalités) : data-kou-id="feature-N-title" data-kou-role="feature-title", data-kou-id="feature-N-sub" data-kou-role="feature-sub"

    Sans cela, le tableau elements du sidecar de mise en page sera vide et le QA post-rendu sera aveugle. Voir les exemples de modèles dans design-guide.md pour les modèles d'annotation corrects.

  9. Créez config.yaml avec la configuration koubou (lisez yaml-reference.md pour le format)

  10. Utilisez du CSS qui s'adapte au canevas et à la longueur de la copie : utilisez vw ou clamp() délibérément, privilégiez CSS Grid, le chevauchement et les couches positionnées en absolu, et vérifiez l'échelle de texte calculée finale sur le canevas réel

  11. Avant d'écrire du HTML : planifiez les zones de texte/appareil pour chaque diapositive (quelle zone possède quel pourcentage du canevas). Ne commencez pas le CSS tant que les zones ne sont pas claires

  12. Exécutez : kou generate config.yaml --output json

  13. Pour chaque capture HTML générée, lisez layout_path à partir du résultat JSON et inspectez le sidecar avant de décider que la mise en page est acceptable

  14. QA post-rendu (obligatoire — ne sautez pas) :

    • Examinez chaque diapositive générée visuellement
    • Ouvrez chaque fichier *.layout.json sidecar référencé par layout_path
    • Vérifiez par rapport à la liste de rejet dans design-guide.md
    • Vérifiez que l'ensemble rendu reflète toujours le style de l'application que vous avez découvert au lieu des valeurs par défaut génériques de l'App Store
    • Utilisez le JSON de mise en page uniquement pour la géométrie objective : positions, espace occupé, proportions et chevauchements mathématiques
    • Si elements est vide pour une diapositive HTML qui devrait être mesurée, considérez cela comme une annotation manquante ou cassée et corrigez le modèle
    • Vérifiez : pas d'icônes émojis, pas de grilles de cartes identiques, pas d'appareils décentrés, pas de texte en dessous de l'échelle minimale, pas de recadrage involontaire de l'appareil (le haut/encoche de l'appareil doit être visible sur les diapositives hero ; le contenu de l'écran doit être lisible)
    • Appliquez le test d'échange de logo : ces diapositives fonctionneraient-elles pour un concurrent ?
    • Si une diapositive échoue, corrigez et régénérez avant de la montrer à l'utilisateur
  15. Ouvrez le dossier de sortie : open <répertoire_sortie>

  16. Demandez si l'utilisateur souhaite des ajustements — itérez sur des diapositives spécifiques sans tout régénérer

Règles d'itération

  • Lorsque l'utilisateur demande de modifier une diapositive spécifique, modifiez uniquement ce modèle + l'entrée de configuration
  • Lorsque l'utilisateur demande un changement de style global (couleurs, polices, ambiance, densité, audace), mettez à jour tous les modèles
  • Réexécutez kou generate config.yaml --output json après les modifications pour que les nouvelles valeurs layout_path et les sidecars restent synchronisés
  • Utilisez kou live config.yaml si l'utilisateur souhaite un aperçu en temps réel pendant l'édition
  • Si une diapositive semble petite, augmentez d'abord l'échelle ou changez de mise en page. Ne cachez pas le problème avec des dégradés ou des étiquettes supplémentaires
  • Si la copie force un texte minuscule, réécrivez la copie ou choisissez une mise en page plus appropriée ; n'acceptez jamais une diapositive timide parce que « le texte devait tenir »
  • Maintenez une variété élevée : l'objectif est la cohérence de la campagne, pas la répétition de la mise en page
  • Ne vous arrêtez pas après le premier rendu réussi si la sortie enfreint toujours les règles de conception ou la liste de vérification de rejet
  • Si l'utilisateur demande un changement d'ambiance, réinterprétez l'ensemble dans les limites de qualité au lieu de défendre les valeurs par défaut précédentes
  • Si la capture d'écran et le JSON de mise en page sont en désaccord, faites confiance à la capture d'écran rendue pour le goût et enquêtez sur l'annotation ou le timing du rendu au lieu de forcer une décision de mise en page à partir d'une géométrie obsolète

Règles strictes

Contraintes strictes

  • N'utilisez jamais d'émojis comme icônes — utilisez des formes CSS (barres d'accentuation, points) ou du texte uniquement
  • N'utilisez jamais de phrases de copie interdites — « révolutionnaire », « transparent », « débloquer », « révolutionnaire », etc.
  • Appliquez le test d'échange de logo — si le nom d'un concurrent conviendrait, l'ensemble est trop générique
  • Chaque modèle HTML doit avoir des annotations data-kou-id — au minimum : headline, subtitle et device. Si elements dans le sidecar de mise en page est vide après la génération, les annotations sont manquantes — corrigez le modèle avant que le QA ne passe. Ne présentez pas de diapositives non annotées à l'utilisateur.

Échelle

  • Sur les portraits iPhone hauts (iPhone6_9, iPhone6_7), les titres hero doivent être >=10vw, les titres de mise en page latérale >=10vw, les sous-titres >=4.5vw
  • Utilisez vw ou clamp() uniquement si la taille calculée dépasse toujours le minimum sur le canevas cible
  • Sur les diapositives de contraste ou de clôture, le cluster de contenu doit occuper 60 %+ de la hauteur du canevas

Valeurs par défaut fortes

  • N'utilisez pas la même composition de téléphone droit centré sur des diapositives consécutives
  • Ne laissez pas de grandes bandes vides (>15 % de la hauteur du canevas) entre le titre et l'appareil
  • Évitez de combiner rotate() + translate() sur les appareils centrés à moins que le centre visuel ne semble toujours intentionnel après le rendu
  • N'utilisez pas une simple colonne flex centrée lorsque la diapositive a besoin de chevauchement, de recadrages de bord ou de composition en couches
  • Planifiez les zones de texte/appareil avant d'écrire du CSS (voir design-guide.md Planification des zones appareil-texte)
  • Si vous utilisez des grilles de cartes, décalez, mettez en évidence ou simplifiez-les, sauf si une grille stricte sert véritablement le concept

Contenu

  • N'ajoutez pas de petites étiquettes de catégorie, de titres de nom d'application par défaut
  • Ne rendez pas le nom de l'application sous forme de petit texte décoratif, sauf s'il est clairement lisible

Skills associés