Communitygithub.com

homepage-maker

Montre à un agent comment réaliser une page d’accueil, un portfolio ou un site vitrine de manière professionnelle, en s’appuyant sur des références réelles, en documentant ses sources et en respectant les obligations légales.

Qu'est-ce que homepage-maker ?

Ce skill guide un agent IA (Claude Code, Cursor, etc.) à travers un processus structuré pour créer des pages d'accueil, des portfolios ou des sites vitrine qui évitent l'apparence « faite par une IA » (titre centré, dégradé violet, trois cartes). Il impose une recherche préalable (concurrents, informations client, réglementations), la capture et l’analyse de 5 à 8 sites de référence réels avec attribution obligatoire via `data-ref`, et une vérification automatisée via `scripts/homepage.mjs`. Le workflow comprend des étapes bloquantes (validation humaine nécessaire) pour les propositions de direction créative et l’approbation finale. Il intègre des « portes » (gates) qui échouent si les références sont insuffisantes, les informations factuelles manquantes, ou si des obligations légales locales (JSON-LD, origine des produits, numéro de téléphone, lien map) ne sont pas respectées. Le module `humanize-korean` est optionnel pour améliorer la naturalité du texte. Le déploiement final s’effectue sur Vercel, avec contrôle qualité avant mise en production.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/min9lin9/min9maker-homepage/tree/HEAD

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 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.

QuandRecherche nécessaire
Avant le briefInfos 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 directionsConcurrence, canaux des établissements similaires (avis, description, site web), définition de marque
Avant la finalisation du texteMots-clés, référencement naturel
Avant le déploiementProprié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.

  1. init — Vérifier (avec le tableau ci-dessus) que la recherche préalable est terminée, puis créer sites/<slug> avec brief.md, facts.md, refs.md, site/, refs/.
  2. 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).
  3. 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.
  4. 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).
  5. 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 dans refs/<slug>/ et enregistrés dans refs.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 dans references/moves.md.
  6. ⛔ Proposition de trois directions — Avec board, générer out/board.png et un dossier out/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.
  7. Construction section par section — Construire site/index.html (et les CSS/images dans site/) section par section. Chaque <section> doit porter data-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 dans references/korea-local.md.
  8. Révision du texte — Avec copy, extraire tout le texte visible de la page par bloc dans sites/<slug>/_workspace/<date>-NNN-<tag>/01_input.txt (les mentions de source d'image, licences et zones data-copy-skip sont exclues). Si humanize-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étence humanize-korean, créer final.md, passer verify_gates.py, puis ne reporter dans site/ 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.
  9. check — Corriger jusqu'à ce qu'il n'y ait plus d'échec (✗). Pendant le travail, --draft permet d'abaisser les échecs en avertissements, mais la livraison et le déploiement doivent passer sans --draft.
  10. Comparaison visuelle — Avec shots --compare, générer out/compare.png et le visualiser côte à côte avec les références choisies. Ouvrir aussi out/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.
  11. ⛔ Approbation — Obtenir l'approbation avec compare.png, site-mobile.png et out/report.json.
  12. Déploiement — deploy ne met en ligne sur Vercel que si check ré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 ; --prod n'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 le robots.txt bloque les agents Claude (Godly, GDWEB) seront rejetés par ref. 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.md et 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 pour carousel-maker.
  • Chaque image doit faire 500 Ko maximum (WebP/AVIF recommandé), et le poids total du site doit être inférieur à 3 Mo.

Portes

PorteCondition d'échec
refsMoins de 3 références avec « ce qui est repris » renseigné
attributionSection sans data-ref, ou référence pointant vers un dossier inexistant dans refs/
factUn nombre présent sur la page n'est pas dans facts.md
placeholderPrésence de [...], 【...】, lorem, TODO
claim · originExpression exclusive sans justification, ou menu viande + prix sans ligne d'origine
localAbsence d'au moins un des éléments suivants : JSON-LD LocalBusiness/Restaurant, lien tel:, lien Google Maps/Kakao, horaires d'ouverture
metaAbsence de og:title, og:image, lang="ko", viewport
koreanAbsence de word-break: keep-all dans le body
a11y · contrastImage sans alt, contraste WCAG AA insuffisant
mobileDéfilement horizontal à 390px, texte principal en dessous de 16px (boutons < 44px : avertissement)
template · weightDégradé violet, expressions passe-partout, images lourdes (avertissement)
copy-styleScore 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 MCPhomepage-maker
RéférencesUne seule source, curation éditoriale MuzliCollections publiques Muzli + SiteInspire, Land-book, Lapa Ninja, One Page Love, Awwwards
Attribution des sourcesDite oralement dans la conversationImposée via data-ref sur chaque section, échec si absente
Analyse des référencesImage et descriptionCaptures desktop et mobile + tokens police, taille, couleur, largeur
Vérification du résultatAucunePortes : faits, réglementation, informations locales, mobile, contraste, coréen + score AI-ness (humanize-korean)
Revue visuelleAucuneImage de comparaison côte à côte avec les références
DéploiementMuzli.space (non indexé, pas de formulaire, limite 10 pages)Vercel (indexé, nom de domaine personnalisé possible)
Secteurs coréensAucunGoogle Maps, réservation, JSON-LD, origine des produits, césure coréenne
Points forts de MuzliCurations basées sur 900 000 designers, utilisation de ma liste personnelleUtilisation uniquement de collections publiques, pas de personnalisation

Skills associés