open-design-landing
Construisez un site vitrine éditorial monopage (ou un diaporama — voir le
skill frère open-design-landing-deck)
dans le système de design Atelier Zero : fond papier chaud, Inter
Tight + Playfair Display, accents en italique serif, filets pointillés,
points de terminaison corail, animation au défilement et 16 planches
de collage surréalistes.
C'est la recette canonique de la page marketing Open Design — l'exemple de sortie est exactement la page que vous voyez sur open-design.
Le skill est entièrement paramétré. L'agent remplit un inputs.json
typé à partir du brief de l'utilisateur ; le compositeur transforme ce
JSON + la feuille de style canonique styles.css en un
artefact déployable.
inputs.json + styles.css 16 emplacements d'images
│ │
└──────────► scripts/compose.ts ◄────────────┘
│
▼
<out>/index.html (auto-contenu)
<out>/assets/ (PNG ou SVG)
Ce que vous obtenez
Un fichier HTML unique avec tout ceci :
- Barre éditoriale supérieure (volume / numéro / langue), navigation collante style Headroom avec compteur d'étoiles GitHub en direct.
- 8 sections numérotées en chiffres romains avec fond texturé papier :
hero (avec 3 anneaux de stats + index en 4 étapes), à propos,
capacités (4 cartes), labs (5 cartes + filtres + barre de progression),
méthode (4 étapes avec vignettes), travaux sélectionnés (dalle sombre
- 2 cartes inclinées), témoignage (citation + 5 glyphes partenaires), CTA (ruban + pilule email).
- Pied de page avec 4 colonnes de liens + un mot d'accroche en italique serif géant.
- Animation au défilement sur chaque section (IntersectionObserver,
respecte
prefers-reduced-motion). - Entièrement responsive aux points de rupture 1280 / 1080 / 880 / 560.
Contrat de workflow
Exécutez ces quatre étapes dans l'ordre. L'agent doit terminer chaque étape avant de passer à la suivante, et préférer poser une question ciblée à l'utilisateur plutôt que d'inventer du contenu.
1. Collecter les inputs de la marque
Utilisez AskQuestion (ou l'équivalent dans votre UI) pour collecter
le brief de la marque par morceaux ; ne déversez pas tout le
schema.ts sur l'utilisateur. Mappez leurs réponses dans inputs.json
selon la structure typée.
Les huit groupes de questions, dans l'ordre :
| Groupe | Champs du schéma | Réponses min | Notes |
|---|---|---|---|
| 1 | brand.{name,mark,tagline,description,location} | 5 | Mark = glyphe unique (Ø, ▲, ★…) |
| 2 | brand.{license,version,year,primary_url,contact_email} | 4 | URL obligatoire ; licence par défaut Apache-2.0 |
| 3 | nav[] (jusqu'à 5) | 3 | Badges de comptage optionnels |
| 4 | hero.{label,headline,lead,primary,secondary,stats} | Tous | Titre en MixedText (sans+em+point) |
| 5 | about + capabilities.cards[4] | Tous | 4 cartes × {num,tag,title,body} |
| 6 | labs.cards[5] + method.steps[4] | Tous | Les deux grilles de taille fixe |
| 7 | work.cards[2] + testimonial | Tous | 5 glyphes partenaires en données de chemin SVG inline |
| 8 | cta + footer.{columns[4],mega} | Tous | Mot d'accroche méga est un MixedText comme les titres |
Ouvrez inputs.example.json pour un exemple
complet (Open Design lui-même).
2. Décider de la stratégie d'image
| Stratégie | Quand choisir | Coût / latence |
|---|---|---|
placeholder | Première passe. Démo. Interne. Pas de budget image encore. | 0 $, <1s |
generate | Livraison finale. La marque veut des collages originaux. | ~0,40 $, ~6 min |
bring-your-own | L'utilisateur a des PNG de direction artistique. Déposez-les dans assets_path. | 0 $, 0s |
Définissez inputs.imagery.strategy en conséquence.
placeholder — mode cadre
npx tsx scripts/placeholder.ts <out>/assets/
Écrit 16 fichiers .svg (avec des alias .png pour la compatibilité)
dans <out>/assets/. Chaque placeholder affiche l'identifiant
d'emplacement, le ratio, les dimensions en pixels et l'indice de
prompt provenant de image-manifest.json. Le <img src='./assets/hero.png'> du compositeur fonctionne immédiatement.
generate — mode gpt-image-2
FAL_KEY=... npx tsx scripts/imagegen.ts <inputs.json> --out=<out>/assets/
Appelle le point de terminaison synchrone openai/gpt-image-2 de
fal.ai pour chaque emplacement. Compose les invites comme suit :
ancrage stylistique (système éditorial collage papier) +
variables de marque (nom / navigation / titre / accent italique
tirés de inputs.json) + composition par emplacement (ex. tête
en plâtre recadrée + arbre poussant à travers une arche). Ignore les
emplacements dont le fichier cible existe déjà ; passez --force pour
regénérer.
Sans FAL_KEY, le script affiche les invites afin que l'opérateur
puisse les acheminer manuellement via la commande slash /gpt-image-fal
d'un skill.
bring-your-own
Déposez 16 PNG correspondant aux noms de fichiers de
assets/image-manifest.json dans inputs.imagery.assets_path. Terminé.
3. Composer l'artefact
npx tsx scripts/compose.ts <inputs.json> <out>/index.html
Le compositeur lit inputs.json et ../styles.css, puis écrit un
fichier HTML auto-contenu. La page inclut :
- La feuille de style complète d'Atelier Zero, intégrée en ligne.
- Tout le balisage des sections avec les attributs
data-revealpour l'animation décalée au défilement. - Le script IntersectionObserver intégré (miroir de
apps/landing-page/app/_components/reveal-root.tsx). - Le script de navigation Headroom intégré (miroir de
header.tsx). - Le récupérateur de compteur d'étoiles GitHub intégré (détection automatique
depuis
brand.primary_url).
4. (Optionnel) Miroir du site Astro déployable
Pour une sortie de production déployable, forkez le package
apps/landing-page/ : copiez-le dans votre espace de travail,
alignez app/page.tsx avec le contenu de votre inputs.json, et
copiez vos <out>/assets/*.png dans les chemins attendus par
app/image-assets.ts / les URLs R2. Compilez avec
pnpm --filter @open-design/landing-page build pour un export
statique out/ prêt pour tout CDN.
Une itération future pourrait regrouper un compositeur qui émet l'arborescence complète de
apps/landing-page/à partir deinputs.jsonen une seule commande. En attendant, le fork-et-édition est le chemin pris en charge.
Auto-vérification avant livraison
Avant de marquer comme terminé, l'agent doit vérifier :
-
<out>/index.htmls'ouvre dans un navigateur sans erreur console. - Les 16 emplacements d'images se chargent (pas de 404 dans l'onglet réseau des DevTools).
- Les accents en italique des titres s'affichent en Playfair (pas en sans).
- Les points de terminaison corail apparaissent à la fin de chaque
displayh1/h2. - Défilement de haut en bas ; chaque section s'anime une fois.
- Redimensionnement à 880px et 560px ; pas de défilement horizontal, pas de chevauchement.
-
prefers-reduced-motion: reduce(DevTools → Rendu) désactive proprement les transitions. - Lighthouse : contraste AA, swap de police d'affichage, pas de changement de mise en page sur le hero (CLS < 0,05).
Fichiers dans ce skill
skills/open-design-landing/
├── SKILL.md # ce contrat
├── README.md # démarrage rapide
├── schema.ts # inputs typés (source unique de vérité)
├── styles.css # feuille de style Atelier Zero (source unique de vérité)
├── inputs.example.json # Open Design comme exemple concret
├── example.html # rendu canonique (regénéré depuis inputs.example.json)
├── scripts/
│ ├── compose.ts # inputs.json + styles.css → index.html
│ ├── imagegen.ts # wrapper gpt-image-2 (fal.ai)
│ └── placeholder.ts # cadres SVG texturés papier
└── assets/
├── *.png # 16 planches de collage (instance Open Design)
├── image-manifest.json # mapping emplacement → fichier/dimensions/invite
└── imagegen-prompts.md # pack d'invites lisible par un humain
Limites
- N'inventez pas de nouvelles couleurs ou polices. Les jetons se
trouvent dans
design-systems/atelier-zero/DESIGN.md; étendez le système de design avant d'ajouter une nouvelle rampe ici. - Ne supprimez pas les attributs
data-revealdu balisage généré. Sans eux, la page devient statique et semble morte. - N'enveloppez pas le HTML composé dans un framework qui injecte son propre ordre de feuilles de style — Atelier Zero repose sur la cascade d'ordre des feuilles de style pour la texture du papier et l'index z des rails latéraux.
- N'ajoutez pas de fichier de feuille de style séparé pour le fork
Astro de la landing-page ; copiez
styles.csstextuellement dansapp/globals.csspour que la parité visuelle reste exacte.
Voir aussi
design-systems/atelier-zero/DESIGN.md— spécification des jetons.apps/landing-page/— contrepartie statique Astro déployable.skills/open-design-landing-deck/— skill frère de diaporamas qui réutilise ce système de design.
