Que fait homepage-maker ?
Compétence pour éviter les pages qui sentent l'IA (titre centré, dégradé violet, trois cartes) en agissant comme un designer : d'abord observer de vrais sites bien faits, citer ce qui est repris et d'où ça vient, ne rien oublier des informations indispensables à une boutique locale. Le rendu et la vérification sont effectués par scripts/homepage.mjs.
SK=.claude/skills/homepage-maker/scripts/homepage.mjs
node $SK init sites/<slug>
node $SK ref sites/<slug> <url> --note "Une chose à reprendre de ce site"
node $SK board sites/<slug>
node $SK copy sites/<slug>
node $SK check sites/<slug> [--draft]
node $SK shots sites/<slug> --compare <ref1>,<ref2>
node $SK deploy sites/<slug> [--prod]
Première installation : dans le dossier de la compétence, exécuter npm install && npx playwright install chromium (voir README). Les commandes s'exécutent depuis la racine du projet. Le score « AI-ness » du texte n'est disponible que si humanize-korean est présent dans .claude/skills/humanize-korean/ (autres emplacements via HUMANIZE_KOREAN_ROOT).
Recherche préalable
Cette compétence crée la page à partir des résultats de recherche. La seule recherche effectuée directement est la collecte de références de design ; les éléments ci-dessous doivent être déjà prêts. Le tableau suivant détaille le contenu, l'utilisation et les conséquences en cas d'absence dans references/prerequisites.md.
| Quand | Recherche nécessaire |
|---|---|
| Avant le brief | Infos de base client (adresse, téléphone, horaires, parking, réservation, menu, prix, origine des produits), situation du visiteur (qui vient, dans quel contexte), réglementation publicitaire du secteur |
| Avant la proposition des 3 directions | Concurrence, canaux des établissements similaires (avis, description, site web), définition de marque |
| Avant la finalisation du texte | Mots-clés, référencement naturel |
| Avant le déploiement | Propriétaire du domaine et de l'hébergement, mentions obligatoires (si formulaire de réservation ou de contact) |
Toute valeur non vérifiée doit être marquée « à confirmer » dans facts.md ; check empêchera alors son intégration dans la page.
Procédure
Les étapes marquées ⛔ nécessitent une approbation humaine avant de continuer.
- init — Vérifier (avec le tableau ci-dessus) que la recherche préalable est terminée, puis créer
sites/<slug>avecbrief.md,facts.md,refs.md,site/,refs/. - Brief — Définir un seul objectif d'action du visiteur (trouver le chemin, réserver, appeler). Décrire qui vient et dans quel contexte (ex. : un client en voiture le week-end qui consulte son téléphone avant de partir).
- Fiche d'information — Rassembler adresse, téléphone, horaires, jours de fermeture, parking, lien de réservation, lien Google Maps, menu, prix, origine des produits, avec leurs sources. Les éléments non confirmés sont marqués « à confirmer » et ne sont pas utilisés sur la page. Si un nombre présent sur la page n'est pas dans
facts.md,checkéchoue. - Trouver des références — Chercher 8 à 12 candidats parmi au moins trois sources de
references/sources.md. Ne pas se limiter au même secteur d'activité : choisir des sites qui résolvent bien le même problème (afficher un menu, indiquer un emplacement, montrer un processus). - Capture et enregistrement — Capturer 5 à 8 sites choisis avec
ref. Les captures d'écran desktop et mobile, ainsi que les polices, tailles, couleurs, largeur du texte, degré d'animation, sont sauvegardés dansrefs/<slug>/et enregistrés dansrefs.md. Pour chaque référence, noter en une ligne « ce qui est repris ». Ne pas copier la mise en page, les photos ou le texte. Méthode dansreferences/moves.md. - ⛔ Proposition de trois directions — Avec
board, générerout/board.pnget un dossierout/board/(noindex pour le moteur de recherche, chaque carte contient le lien vers le site original, ce qui est repris et la section concernée). Proposer trois directions issues de références différentes. Pour chaque direction, préciser quelle référence a fourni quoi. Ne pas construire la page tant qu'une direction n'a pas été choisie par une personne. - Construction section par section — Construire
site/index.html(et les CSS/images danssite/) section par section. Chaque<section>doit porterdata-ref="<nom du dossier refs>"pour indiquer la source. Avant de créer une section, revoir la section correspondante dans la référence. Les blocs obligatoires pour une boutique locale sont listés dansreferences/korea-local.md. - Révision du texte — Avec
copy, extraire tout le texte visible de la page par bloc danssites/<slug>/_workspace/<date>-NNN-<tag>/01_input.txt(les mentions de source d'image, licences et zonesdata-copy-skipsont exclues). Sihumanize-korean(epoko77-ai/im-not-ai) est présent dans le projet, la même commande affiche le niveau (light, standard, heavy) et le risque. Utiliser ce dossier d'exécution pour réviser le texte via la compétencehumanize-korean, créerfinal.md, passerverify_gates.py, puis ne reporter danssite/que les phrases modifiées. Ne pas modifier les nombres, noms propres ou citations. Si l'outil est absent, cette étape s'arrête après l'extraction. - check — Corriger jusqu'à ce qu'il n'y ait plus d'échec (✗). Pendant le travail,
--draftpermet d'abaisser les échecs en avertissements, mais la livraison et le déploiement doivent passer sans--draft. - Comparaison visuelle — Avec
shots --compare, générerout/compare.pnget le visualiser côte à côte avec les références choisies. Ouvrir aussiout/site-mobile.png. Vérifier : le type de commerce et sa localisation sont-ils visibles dès le premier écran ? La chose reprise de la référence est-elle réellement vivante ? La page ne ressemble-t-elle pas à un template ? Si des corrections sont nécessaires, revenir à l'étape 7. - ⛔ Approbation — Obtenir l'approbation avec
compare.png,site-mobile.pngetout/report.json. - Déploiement —
deployne met en ligne sur Vercel que sicheckréussit. La première fois, il connecte le dossier (sites/<slug>). Vercel met systématiquement en production le premier déploiement d'un nouveau projet (<slug>.vercel.app) : si des informations provisoires sont présentes, ajouter une bannière « Informations provisoires » en haut de la page. À partir du deuxième déploiement, une URL de prévisualisation est créée ;--prodn'est utilisé qu'après approbation. La connexion d'un nom de domaine personnalisé se fait aussi après approbation.
Règles
- Les sources des références doivent provenir uniquement de la liste autorisée dans
references/sources.md. Les sites dont lerobots.txtbloque les agents Claude (Godly, GDWEB) seront rejetés parref. Ils peuvent être consultés manuellement avec des notes uniquement. - Les captures de références sont destinées à l'analyse.
refs/n'est pas commité dans le dépôt (.gitignore). Les photos, textes et logos des références ne doivent pas être utilisés sur le site. - Les photos livrées doivent être prises par le magasin lui-même. Pas de photos de nourriture générées par IA ni de personnes composites. En phase de maquette, des photos de substitution sous licence claire (CC, etc.) peuvent être utilisées, avec mention « maquette » et source de l'image, ainsi qu'une ligne de source dans
facts.md. - Lors de la création de maquettes avec des informations non définitives, marquer celles-ci comme provisoires dans
facts.mdet ajouter une bannière « Informations provisoires » sur la page. Les numéros de téléphone doivent être des valeurs non attribuées (ex. : 031-000-0000). - Les expressions exclusives (premier, plus grand, unique, originel, classement N) ne sont utilisées qu'avec une justification dans
facts.md. L'affichage d'un menu avec des prix oblige à indiquer l'origine des produits (loi sur l'origine). Mêmes règles que pourcarousel-maker. - Chaque image doit faire 500 Ko maximum (WebP/AVIF recommandé), et le poids total du site doit être inférieur à 3 Mo.
Portes
| Porte | Condition d'échec |
|---|---|
| refs | Moins de 3 références avec « ce qui est repris » renseigné |
| attribution | Section sans data-ref, ou référence pointant vers un dossier inexistant dans refs/ |
| fact | Un nombre présent sur la page n'est pas dans facts.md |
| placeholder | Présence de [...], 【...】, lorem, TODO |
| claim · origin | Expression exclusive sans justification, ou menu viande + prix sans ligne d'origine |
| local | Absence d'au moins un des éléments suivants : JSON-LD LocalBusiness/Restaurant, lien tel:, lien Google Maps/Kakao, horaires d'ouverture |
| meta | Absence de og:title, og:image, lang="ko", viewport |
| korean | Absence de word-break: keep-all dans le body |
| a11y · contrast | Image sans alt, contraste WCAG AA insuffisant |
| mobile | Défilement horizontal à 390px, texte principal en dessous de 16px (boutons < 44px : avertissement) |
| template · weight | Dégradé violet, expressions passe-partout, images lourdes (avertissement) |
| copy-style | Score humanize-korean non low pour le risque, ou chemin non light, ou virgule après conjonction z > 3, ou expression « A pas B » 2 fois et plus (avertissement). Ignoré si l'outil est absent (i) |
Comparaison avec Muzli MCP
| Muzli MCP | homepage-maker | |
|---|---|---|
| Références | Une seule source, curation éditoriale Muzli | Collections publiques Muzli + SiteInspire, Land-book, Lapa Ninja, One Page Love, Awwwards |
| Attribution des sources | Dite oralement dans la conversation | Imposée via data-ref sur chaque section, échec si absente |
| Analyse des références | Image et description | Captures desktop et mobile + tokens police, taille, couleur, largeur |
| Vérification du résultat | Aucune | Portes : faits, réglementation, informations locales, mobile, contraste, coréen + score AI-ness (humanize-korean) |
| Revue visuelle | Aucune | Image de comparaison côte à côte avec les références |
| Déploiement | Muzli.space (non indexé, pas de formulaire, limite 10 pages) | Vercel (indexé, nom de domaine personnalisé possible) |
| Secteurs coréens | Aucun | Google Maps, réservation, JSON-LD, origine des produits, césure coréenne |
| Points forts de Muzli | Curations basées sur 900 000 designers, utilisation de ma liste personnelle | Utilisation uniquement de collections publiques, pas de personnalisation |