Communitygithub.com

webbuild

Créez des sites web professionnels, distinctifs et prêts à pitcher — incluant des héros « 3D » pilotés par le scroll, des scènes Three.js / React Three Fiber en temps réel, des animations GSAP + Lenis et des shaders vidéo traités — qui ne font PAS « généré par IA ». Couvre le brief, le rétro-ingénierie de sites de référence, le système de design (typo, couleur, mise en page, copy), le pipeline héros/asset, les performances et l'accessibilité, le QA visuel avec captures d'écran, un linter anti-slop, le déploiement et le pitch du site à un commerce local.

Qu'est-ce que webbuild ?

webbuild est une compétence IA complète pour concevoir et réaliser des sites web professionnels qui ne ressemblent pas à du contenu généré par IA. Elle guide l'utilisateur à travers toutes les étapes : du brief initial (en évitant les faits inventés), en passant par l'analyse de sites de référence, la création d'un système de design sur mesure, le choix du mode héros (image fixe, vidéo traitée, séquences d'images clés défilées au scroll, scène Three.js/R3F ou page entière 3D), le build guidé par des principes de motion subtils, jusqu'au QA visuel rigoureux avec captures d'écran et un linter anti-slop, puis le pitch et le déploiement. Elle est idéale pour les commandes de type « refaire le site d'un commerce », « créer un site style Awwwards », ou « améliorer un site qui a l'air trop IA ». La compétence fonctionne avec tout framework, mais recommande le HTML/CSS/JS vanilla pour la simplicité et la performance, tout en supportant Next.js, Astro ou R3F si l'utilisateur le demande. Le cœur de l'approche est de faire des choix réfléchis avant d'écrire une ligne de code, puis d'évaluer honnêtement le résultat final.

Compatible avec~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Harishisonline/webbuild-skill/tree/main

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 webbuild ?

Créez des sites web pour lesquels un chef d'entreprise paierait : spécifiques à lui, rapides sur mobile, un moment mémorable, et rien qui crie « une IA a fait ça ». Le savoir-faire réside surtout dans les choix avant le code et dans le regard honnête porté sur le résultat après.

Les chemins ci-dessous sont relatifs au dossier de cette compétence (scripts/, references/, assets/).

0. Configurer le projet (2 min)

  • Nouveau site → copier assets/starter/ dans le dossier du projet (HTML + CSS + modules ES, imports CDN épinglés, pas de build : déploiement partout, facile à éditer). N'utiliser Next.js / Astro / R3F que si l'utilisateur le demande ou si le projet les utilise déjà (references/3d-playbook.md §5).
  • Projet existant → conserver son framework, ses tokens et ses composants ; cette compétence ajoute la direction, le motion design et le QA, pas une réécriture.
  • Créer BUILD_NOTES.md dans le projet. C'est la mémoire entre les remises à zéro du contexte : brief, décisions, questions ouvertes, corrections qui ont fonctionné.

1. Brief — obtenir le vrai business

Rassembler (auprès de l'utilisateur, du site actuel du commerce, du Google Business Profile, Instagram) : nom, ce qu'ils vendent, où, depuis quand, la seule action primaire (appeler / réserver / commander / devis / visiter), une preuve réelle (note + nombre d'avis, années d'activité, licences, presse), des photos réelles, logo/couleurs, horaires, adresse, téléphone. Rédiger le brief en 5 lignes depuis references/design-system.md §2 dans BUILD_NOTES.md.

N'inventez jamais de faits — des avis, statistiques, prix ou adresses fabriqués dans un pitch détruisent la confiance dès que le propriétaire les lit. À la place :

  • Écrire autour des inconnues pour que la démo reste aboutie : « Koregaon Park, Pune » au lieu d'un numéro de rue inventé ; « Noté 4,7 sur Google » au lieu de citations inventées ; des noms de services sans prix, ou « à partir de …€ » seulement si connu.
  • Quand un fait est vraiment requis (téléphone, adresse exacte, horaires), utiliser un {{placeholder}} visible — slop_check.py bloque le livrable jusqu'à ce qu'il soit rempli.
  • Mettre chaque inconnue et chaque hypothèse dans une liste « À demander au client » pour le rapport final.

Pour un site de créateur ou de chaîne, demander (ou récupérer) les chiffres du tableau de bord et la photo de profil en amont : captures YouTube Studio / Instagram Insights, plus vidIQ ou similaire si connecté. Une section Résultats bâtie sur des chiffres réels est ce qui vend le projet.

Si le brief est mince et que l'utilisateur est présent, poser au maximum 3 questions (commerce + ville, action primaire, un site qu'ils aiment). S'ils veulent que vous y alliez, faire des hypothèses raisonnables, les écrire, et continuer.

2. Référence (quand l'utilisateur nomme un site, envoie un enregistrement ou veut une « reconstruction »)

Suivre references/reverse-engineer.md : node scripts/teardown.mjs <url> mesure la stack, les polices, la palette, les médias et les indices de shaders et capture le défilement ; les enregistrements d'écran deviennent des images que vous lisez et transformez en spécification de mouvement battement par battement. Quand cette passe rapide ne peut pas expliquer un effet, aller plus loin avec le moteur REA : scripts/rea-teardown.sh <url> capture la page, identifie le bundle et exporte chaque script pour que vous puissiez lire comment il est réellement construit (guides dans references/rea/). Enregistrer OBSERVÉ → INFÉRENCE → DÉCISION. Apprendre la technique ; ne jamais copier la marque, le copy, les assets ou le code.

3. Direction — planifier, puis attaquer le plan

Lire references/design-system.md (les règles anti-slop — classiques et les signes plus récents de l'IA « de bon goût » comme crème + terre cuite, les titres en CAPITALES, les filets éditoriaux). Dans BUILD_NOTES.md, écrire :

  • 4 à 6 tokens de couleur nommés tirés du commerce, appairage de polices + rôles, langage des coins
  • wireframe ASCII de chaque section (varier le rythme — pas de hero → 3 cartes → logos → témoignages)
  • le moment signature (un seul) et pourquoi il correspond à ce commerce
  • 3 principes qui le rendent distinctif

Ensuite, passer le plan en revue par rapport à la liste des signes et, pour chaque choix qui ressemble à une valeur par défaut, le justifier pour ce commerce ou le changer. Se demander « est-ce que cela pourrait appartenir à un autre commerce si je changeais le logo ? » attrape la plupart des problèmes ici, quand ils sont peu coûteux.

Pour une direction indécise que l'utilisateur veut choisir, montrer 2 à 3 directions vraiment différentes (une image fixe ou une esquisse HTML rapide chacune) avant de construire — 21st-ui-explore peut aider s'il est installé.

4. Hero — choisir le mode qui sert le commerce

references/3d-playbook.md §1 contient le tableau de décision. Version courte :

  • fixe (belle photo/typo) — restaurants, salons, cliniques, services. Souvent le bon choix.
  • vidéo — boucle d'ambiance, idéalement traitée avec assets/starter/grade.js pour que les images IA/stock reçoivent un grade sur mesure (grain, halation, lift/gamma/gain, vignette). Choisir un LOOK et le garder subtil.
  • images clés — le « site 3D à 10 000€ » : images clés IA de début/fin → vidéo première/dernière image → scripts/frames.sh → canvas défilé par le scroll. Lire references/scroll-video-playbook.md pour les règles d'images clés, les prompts et le mélange.
  • scène — Three.js / R3F en direct quand la 3D est l'histoire du produit (produit configurable, architecture, tech). Le sujet doit être la chose du commerce, jamais le nœud générique.
  • page entière — quand le propriétaire demande un « site 3D », il veut généralement de la 3D partout, pas seulement un hero 3D. Utiliser une scène fixe avec une caméra par section (references/3d-playbook.md §6).

Générer les assets avec ce qui est connecté (Higgsfield / Kling / kie.ai / Nano Banana MCPs ou compétences), ou demander à l'utilisateur de déposer les fichiers. Si rien n'est disponible, construire avec un placeholder clairement étiqueté et lister exactement quel asset générer, avec le prompt.

5. Build

Ordre : tokens (styles.css :root) → sections HTML sémantiques avec le vrai copy → mise en page à 390px et 1440px → mode hero → motion en dernier.

  • Règles de copy : references/design-system.md §8 (résultat + lieu + spécificités, verbes CTA réels, mots interdits).
  • Requis pour un site d'entreprise : un CTA évident au-dessus de la ligne de flottaison et à nouveau à la fin, tel: / réservation / formulaire, horaires + adresse + lien map, preuve réelle, titre + description + image OG, JSON-LD LocalBusiness, favicon, barre d'appel/réservation collante sur mobile quand l'action est un appel.
  • Motion : un moment signature + micro- retour silencieux de 150 à 300 ms ; ease-out, jamais de rebond ; uniquement transform/opacity ; motion réduite affiche les états finaux.
  • Composants : chercher dans les registres references/resources.md (21st.dev, React Bits, Aceternity, Motion Primitives…) avant de coder à la main des effets complexes, puis restyler avec les tokens. Dans un site statique, reconstruire les composants React en vanilla plutôt que d'ajouter React pour un seul effet.
  • Footer : le construire selon references/design-system.md §11 (bloc de marque, colonnes de liens avec logos de plateformes, boutons de contact, mot-symbole surdimensionné, ligne du bas). Les propriétaires jugent tout le site sur le footer. Le petit crédit du constructeur est déjà dans le starter ; le client peut demander à le retirer.
  • Boutons et scroll : suivre references/design-system.md §12 (boutons tactiles de 0,16 s, anneau de curseur via cursor.js du starter, pas de barre de défilement native : blockbar.js du starter la remplace).
  • Avant de considérer le site comme terminé, relire references/design-system.md §10 : ce que les propriétaires appellent encore « slop » alors que toutes les règles sont respectées.

6. Le regarder — c'est là que les bons sites se font

Servir localement (npx serve . ou le serveur de dev du projet), puis :

  1. node scripts/shoot.mjs http://localhost:3000 ./shots — captures d'écran téléphone / portable / bureau le long du défilement + erreurs console, débordement, LCP, poids. Lire les PNG. (Ou utiliser le volet navigateur / Playwright MCP si disponible.) Exécuter aussi une fois avec --reduced-motion.
  2. python3 scripts/slop_check.py . — doit se terminer avec 0 FAIL. Traiter les WARN comme des questions. (npx impeccable detect est un bon second avis s'il est installé.)
  3. Critiquer honnêtement par rapport au brief : hiérarchie, typo, couleur, moment signature, mobile, spécificité du copy. Corriger par lots avec une intention claire ("les sections basses ont l'air génériques — rendez-les plus chères, pas plus chargées").
  4. Soustraire un élément décoratif avant de le déclarer terminé.

Prévoir 3 à 6 cycles ; personne ne réussit du premier coup. Enregistrer ce qui a corrigé quoi dans BUILD_NOTES.md.

7. Livrer + pitcher

  • Déployer : Vercel / Netlify / Cloudflare Pages / GitHub Pages. Commiter le dossier frames (le bug le plus courant : « le hero a disparu en production »). Ajouter <meta name="robots" content="noindex"> aux démos de spécification jusqu'à ce que le client achète.
  • S'il s'agit d'un pitch, lire references/pitch-and-sell.md : vidéo avant/après, scripts de prospection, ancres de prix, checklist prêt-à-pitcher, remise.

Rapport final à l'utilisateur

Rester court et concret :

  • Ce qui a été construit (direction en une ligne, moment signature, mode hero) et où (chemins, URL)
  • Comment l'exécuter (npx serve . ou la commande dev)
  • Résultats du QA : nombres FAIL/WARN de slop_check, LCP / erreurs par viewport de shoot.mjs, ce que vous avez examiné et corrigé
  • Liste À demander au client : chaque {{placeholder}} et hypothèse
  • Assets encore à générer (avec des prompts prêts à l'emploi), le cas échéant

Carte de référence

À lireQuand
references/design-system.mdToujours, avant de choisir couleur/typo/layout/copy
references/3d-playbook.mdChoisir le hero ; tout Three.js/R3F ; budget performance + a11y
references/scroll-video-playbook.mdHero « 3D » défilé au scroll à partir d'une vidéo IA
references/reverse-engineer.mdUn site de référence, un enregistrement, ou la reconstruction du site d'un prospect
references/rea/README.mdAller plus loin que teardown.mjs avec les outils REA
references/resources.mdRegistres de composants, outils d'effets, inspiration, compétences compagnons
references/pitch-and-sell.mdSite de spécification pour un prospect, tarification, prospection, remise
ScriptFait
scripts/teardown.mjs <url>Mesurer un site de référence (stack, polices, palette, médias, shaders, captures d'écran)
scripts/rea-teardown.sh <url>Déconstruction approfondie avec le moteur REA : capture de page, empreintes du bundle, scripts exportés
scripts/frames.sh <video> <out>Vidéo → séquences d'images WebP (desktop + mobile) + manifeste
scripts/shoot.mjs <url> [out]Captures d'écran à 3 largeurs le long du défilement + erreurs/LCP/débordement
scripts/slop_check.py <dir>Linter anti-slop + préparation à la livraison (0 FAIL pour livrer)

Playwright pour les scripts .mjs : npm i -D playwright && npx playwright install chromium.

Skills associés