Communitygithub.com

manual-de-marca

Crée le manuel de marque (brandbook) sous forme de deck Slides à partir du logo SVG et de la proposition de branding déjà approuvée : versions du logo, grille, zone de protection, tailles minimales, couleur CMJN/Pantone, typographie avec licences et .zip du logo.

Qu'est-ce que manual-de-marca ?

Cette compétence transforme une identité visuelle déjà validée (logo + stratégie) en un manuel normatif complet, destiné au client, à son équipe et à ses prestataires. Elle fonctionne sur les principaux agents de codage comme Claude Code ou Cursor, en guidant l'utilisateur étape par étape à travers neuf phases : de la collecte des entrées obligatoires (SVG du logo et deck de branding) à l'assemblage final du deck Google Slides et du package de fichiers. Chaque décision est documentée de manière mesurable (tailles, couleurs, contrastes) et la compétence pose toujours une question à la fois, avec une recommandation et la raison associée, pour éviter toute invention non approuvée. Elle utilise des scripts Python internes pour analyser le SVG, générer des variantes de couleur, calculer les grilles de construction, les tailles minimales, le système colorimétrique (CMJN, Pantone, contraste) et les lock-ups, garantissant que le manuel reste précis et défendable devant le client.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/albdanyb22/skills-branding/tree/HEAD/manual-de-marca

Demander à votre IA préférée

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

Documentation

Manuel de marque

Tu transformes une identité déjà décidée (logo + stratégie) en un manuel normatif : le document qui indique au client, à son équipe et à ses prestataires comment utiliser la marque sans que la designer ne soit présente. Le manuel documente les décisions ; il ne les prend pas de lui-même. C'est pourquoi cette compétence pose beaucoup de questions et génère peu de choses sans approbation : chaque affirmation du manuel doit pouvoir se défendre devant le client.

Rythme de toute la compétence : une question à la fois, toujours avec ta recommandation et une ligne expliquant pourquoi. Quand la personne accepte sans discuter, nomme en une phrase ce que cela implique (le coût) et continue. Tiens le compte à voix haute ("Bloc 3 sur 6 — Couleur"). Si quelque chose peut être vérifié en regardant (le PPT, le SVG, le site web d'une licence), vérifie-le plutôt que de demander.

Outils

La compétence utilise ses propres scripts et guides, dans scripts/ et references/ à côté de ce fichier. Les scripts utilisent Python avec Playwright/Chromium, Pillow, numpy et scipy ; text_to_svg.py nécessite en plus uharfbuzz (pip install --break-system-packages uharfbuzz). Tous acceptent -h. Guides :

  • references/entrevista.md : banque de questions dans l'ordre, avec la recommandation par défaut.
  • references/nucleo.md : pages du manuel de base.
  • references/modulos.md : modules étendus (tirés du manuel public de la FIFA World Cup 26).
  • references/esqueleto-slides.md : maquette éditoriale fixe et construction technique du deck.

Tiens une liste de tâches visible (analyse, entretien, versions, construction, couleur, deck, package) : le travail est long et la personne peut partir et revenir.

Phase 0 — Entrées obligatoires

Demande en un seul message ce qui manque :

  1. Le logo en SVG, avec le texte en contours. Si seuls des PNG/JPG sont disponibles, arrête-toi : sans SVG on ne peut pas mesurer ni générer des versions fiables. Demande aussi tout autre SVG existant (autres versions, grille de construction).
  2. La présentation de branding précédente : Google Slides (celle produite par propuesta-branding), .pptx ou PDF. Si elle n'existe pas, arrête-toi et suggère d'exécuter propuesta-branding : le manuel n'invente pas de stratégie.

Lis la présentation (pour .pptx, python -m markitdown ou python-pptx ; extrais aussi les images des pages d'identité visuelle et regarde-les : c'est là que se trouvent généralement le système de logo, la palette appliquée et les pièces). Élabore une fiche : qui nous sommes, mission, vision, valeurs, personnalité, ton (dit / évite), positionnement, mantra, concept du logo, moodboard, type board, palette, typographies et règles implicites (par exemple "le nom toujours en noir, le préfixe change de couleur"). Si un champ nécessaire au manuel manque, demande uniquement ce champ. Si une couleur apparaît sans HEX lisible, extrais-la de l'image et demande confirmation.

Phase 1 — Analyser le SVG

python scripts/svg_inspect.py logo.svg travail/inspeccion/

Affiche inspeccion.png et propose les groupes. Il s'agit généralement de l'isotope / logotype / tagline, mais si l'identité est dynamique (une partie change de couleur par sous-marque, bâtiment, siège…), groupe par règle de couleur : ce qui change, ce qui est fixe et ce qui accompagne ce qui change. Ainsi chaque variante se génère avec une seule instruction. Confirme-les et enregistre-les dans travail/grupos.json (par exemple {"prefijo": ["1-4"], "nombre": ["5-10"], "simbolo": [0]}). Gère les ALERTES : texte vivant, traits non expansés, dégradés, images intégrées.

Phase 2 — Entretien

Suis references/entrevista.md (6 blocs : périmètre → logo → couleur → typographie → langage visuel et applications → contrôle du document). Tu peux considérer comme résolues dans un même message les décisions à faible risque ("je suppose X sauf si tu me corriges") ; celles qui coûtent cher à revenir en arrière vont seules.

À la fin, présente la table des matières résultante (noyau + modules, avec numéro de page) et attends l'approbation avant de produire quoi que ce soit.

Phase 3 — Versions du logo (toujours avec approbation préalable)

Variantes de couleur. Génère la proposition et affiche-la comme une feuille ; puis un tableau : groupe de variantes · comment c'est résolu · usage, plus les décisions que tu as prises. Les doutes typiques à soulever ou à résoudre avec le tableau de contraste de la Phase 5 :

  • En négatif, la couleur se maintient-elle ou passe-t-elle en blanc ? Un négatif en couleur n'existe que si cette couleur contraste avec le fond sombre (≥ 3:1) ; sinon, monochrome blanc.
  • Sur un fond qui est une couleur de la palette elle-même, le logo se place en une seule teinte (noir ou blanc), jamais dans une autre couleur de la palette.
  • Dans une couleur, un détail intérieur se fond-il avec la forme derrière ? Propose de découper ("percer" dans le spec).
  • Dans les identités dynamiques : la pièce accompagnante (le symbole, par exemple) peut-elle prendre une couleur différente ? Recommande que non (une pièce = une couleur) et nomme le coût.
python scripts/logo_variants.py logo.svg travail/variantes.json travail/versiones/ --version empilée

Recompositions (horizontal ↔ vertical, symbole seul, avatar, lock-ups) :

  1. Demande si le SVG existe déjà ; s'il existe, utilise-le.
  2. Sinon, compose-le avec compose.py : seulement déplace, met à l'échelle et sépare les pièces existantes ; ne redessine jamais. Pour passer de deux lignes à une seule, utilise "aligner": "ligne de base" avec la ligne de base de chaque groupe (pied d'une lettre sans descendante) et un espacement égal à l'espace entre les lettres dans le mot, pour qu'il se lise comme un seul mot.
  3. Affiche l'aperçu (pour l'avatar, aussi _circulo.png ; pour le favicon, le test à 32 et 16 px) et attends l'approbation une par une.
  4. Une fois approuvée, génère ses variantes en composant chaque variante de couleur approuvée (boucle sur les SVG de la version principale).

Lock-ups avec texte (slogan, nom de sous-marque ou bâtiment) : convertis le texte en contours avec la typographie de marque, sans dépendre de la police installée, et ajoute-le comme pièce externe :

python scripts/text_to_svg.py "Connecte. Vis. Appartiens." source.woff travail/slogan.svg --couleur "#1D1D1B"

(les polices de Google Fonts s'obtiennent avec npm i @fontsource/<famille> ; utilise le .woff). Dans compose.py, "externes": {"slogan": "travail/slogan.svg"} et "largeur": {"slogan": "logo"} égalisent la largeur à celle du logo. Pour une sous-marque sans nom défini, laisse un marqueur ("[Nom]") et normalise la structure, pas chaque cas. Le texte du lock-up se place dans la teinte de la partie fixe du logo, jamais dans la couleur variable.

Usages incorrects, avec le logo réel (--fond-mauvais : la couleur de la palette avec le plus mauvais contraste pour la version principale) :

python scripts/incorrect_uses.py travail/versiones/<principale>.svg travail/incorrectos/ --groupes g.json --nom "<marque>" --fond-mauvais "#2B57E2"

(g.json nécessite un groupe isotope avec le symbole et le reste comme logotype).

Phase 4 — Grille, protection et taille minimale

  1. Demande si la personne a une grille de construction et demande son SVG. Si elle l'a, utilise-la telle quelle. Sinon :
  2. python scripts/construction.py candidats logo.svg travail/constructif/ --groupes travail/grupos.json et affiche les candidats sur une seule feuille. Cela fonctionne généralement bien d'en combiner deux : l'épaisseur du trait comme module du plan (tombe sur les hampes) et la largeur du symbole comme mesure de la zone de protection ("laisse libre l'espace d'un symbole", facile à expliquer à tout prestataire). Cobranding : le double.
  3. python scripts/construction.py plan <version>.svg travail/constructif/<version> --module <u> --protection <modules> pour chaque version.
  4. python scripts/min_size.py <version>.svg travail/minimos/<version> --groupes g.json (g.json avec logotype et, s'il y en a, tagline). S'il y a des fentes fines (la croix d'un symbole), le script donne deux seuils : [complet] tout se lit / [lisible] le nom se lit et le symbole reste comme un point. Élabore une feuille de test avec chaque version à plusieurs tailles (réelle et agrandie) et laisse la personne choisir. L'habitude : le minimum officiel est le [lisible], et dans les petits formats (signature, badge) le symbole apparaît en plus à part et en grand.

Phase 5 — Système de couleur

  1. Élabore travail/colores.json : un HEX source par couleur, rôle, et les RVB/CMJN/Pantone qui viennent du matériel source, pour les valider.
  2. Si la personne n'a pas de Pantone validés, propose-toi pour faire le travail : python scripts/pantone_ref.py travail/colores.json travail/pantone_ref.json (Pantone C et textile TCX les plus proches par ΔE 2000). Copie le résultat dans colores.json et présente-le dans un tableau avec le ΔE : < 2 presque identique, 2–5 similaire, > 5 se voit, > 10 sans équivalent.
  3. python scripts/color_system.py travail/colores.json travail/couleur/ : convertit en CMJN avec le profil FOGRA39 s'il le trouve, avertit des couleurs hors gamme (comment elles apparaîtront imprimées), valide RVB/HEX, calcule les échelles 50–950 et la matrice de contraste.
  4. Présente les ALERTES avant de concevoir. Explique quelles couleurs deviennent ternes en CMJN et où il convient d'utiliser du Pantone direct (autocollants, signalétique). Tout Pantone/TCX calculé va dans le manuel comme "référence, valider avec guide physique et épreuve couleur". Ne le présente jamais comme officiel. Pour le noir, distingue le noir enrichi (grandes zones) du 0/0/0/100 (textes).
  5. La matrice de contraste décide la teinte du texte et celle du logo sur chaque fond. Si le PPT dit "X toujours en noir" et que le contraste l'empêche sur un fond, dis-le et propose la règle corrigée ("X dans la teinte qui contraste").

Phase 6 — Typographie et licences

Cherche la licence de chaque police sur le web avant de demander :

  • Google Fonts / OFL : prête.
  • "Gratuite pour usage personnel" : ne couvre pas un logo commercial. Demande d'où elle vient.
  • Envato Elements : couvre les logos, mais il faut enregistrer la police pour ce projet tant que l'abonnement est actif et conserver le certificat PDF. Si ce n'est pas fait, c'est la priorité la plus importante ; mets dans le manuel un marqueur du code de licence.
  • Restreinte à un système (par exemple SF Pro) : préviens et propose une alternative libre.

La police du logotype, si elle est livrée en contours, se déclare "uniquement dans l'art du logo ; ne s'installe pas". Définis une police de secours (Google Docs/Canva et Word) et la hiérarchie avec des exemples écrits avec la voix de la marque.

Illustrations tierces (banques, communauté Figma) : vérifie aussi leur licence (Streamline Free, par exemple, exige attribution, en permet 25 par projet et interdit de les redistribuer). Si elles ne peuvent être livrées à des tiers, le manuel les montre comme style de référence avec le crédit, et elles ne vont pas dans le .zip. Pour les amener depuis Figma, utilise le connecteur officiel (create_session → get_metadata → get_screenshot avec base64 ; le fichier est sauvegardé sur le disque). Dans le plan Starter, les appels sont limités : repère et choisis avant de télécharger. Si le connecteur local de Figma renvoie "Token expired", le token se change dans la configuration de l'application (ou dans Paramètres → Extensions), pas dans le fichier ; en attendant, utilise le connecteur officiel ou demande l'exportation.

Phase 7 — Construire le deck

Lis references/esqueleto-slides.md. Crée le deck à partir du type Slides (titre : "Manuel de marque – ") et suis ses instructions de fichiers :

  1. Rends en PNG transparent tout ce qui va dans le deck (versions, plans, tests de minimum, usages incorrects, illustrations) et télécharge-les comme ressources depuis un dossier du répertoire de travail, jusqu'à 25 par appel.
  2. deck.json d'abord, avec l'ordre complet (noyau + modules + séparateurs) et les polices de la marque dans faces (Google Fonts) ; puis la couverture, et ensuite des lots de 6–8 pages.
  3. Textes de stratégie : depuis le PPT, en registre de manuel, sans ajouter d'affirmations. Ce qui manque va entre crochets ("[email]"), sur la page et dans les notes de l'orateur.
  4. Applications du secteur : construis-les dans la slide avec des formes, le PNG du logo et des textes d'exemple avec la voix de la marque. Ce ne sont pas des maquettes photographiques.
  5. Vérifie que le nom de la marque est correct dans les en-têtes et la table des matières.

Phase 8 — Package de fichiers

Copie dans un dossier uniquement les SVG approuvés, avec le nom <version>_<variante>.svg (sans aperçus ni pièces détachées), et exécute :

python scripts/package.py travail/remise/ travail/paquet/ --marque "<Marque>"

Génère SVG, PNG transparent 500/1000/2000 px et PDF vectoriel par variante, en RVB. Les versions CMJN/Pantone, les versions simplifiées pour broderie et le favicon de 16 px ajusté restent comme "en attente de finalisation artistique". Envoie le .zip avec SendUserFile.

Phase 9 — Remise

Message bref : le deck (sa carte porte déjà le lien), le .zip et la liste des points en suspens groupée par responsable (designer / client / imprimeur). Exemples : enregistrer la licence de la police, valider le Pantone, l'email du responsable de marque, la finalisation artistique pour broderie, la licence des illustrations. Comme étape facultative, propose d'exécuter brand-board ou de produire les modèles.

Bon exemple

Ainsi se documente une décision dans le manuel : concrète, mesurable et avec son état.

Couleur · Bleu
HEX #2B57E2 · RVB 43/87/226 · CMJN 85/65/0/0 (FOGRA39, sort un peu terne)
Pantone 2728 C · ΔE 3,1 (similaire). Référence : valider avec guide physique et épreuve couleur.

Taille minimale · Version horizontale
24 mm / 90 px de large : le nom se lit et le symbole reste comme un point.
Plus petit (signature, badge) : utiliser le symbole à part et en grand.

Mauvais exemple

Pantone officiel : 2728 C
Ne pas utiliser le logo trop petit.

Pourquoi c'est mal : cela présente un Pantone calculé comme officiel et sans ΔE, et le minimum n'a pas de mesure, donc aucun prestataire ne peut vérifier s'il le respecte.

Ce que cette compétence ne fait jamais

  • Redessiner ou "améliorer" le logo : seulement recolorer, percer, déplacer, mettre à l'échelle et séparer des pièces existantes, et convertir en contours de nouveaux textes.
  • Créer une version sans approbation préalable.
  • Inventer une stratégie, des licences ou des données du client, ni présenter des Pantones calculés comme officiels.
  • Mélanger des valeurs de couleur de sources différentes sans les valider.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés