Que fait open-design-landing ?
Construisez un site vitrine éditorial d'une page (ou un deck de diapositives — voir la compétence sœur open-design-landing-deck) dans le système de design Atelier Zero : fond papier chaud, Inter Tight + Playfair Display, plages d'accentuation italique serif, filets pointillés, points terminaux corail, animation scroll-reveal et 16 planches de collage surréalistes.
C'est la recette canonique de page marketing d'Open Design — l'exemple de sortie est exactement la page que vous voyez sur open-design.
La compétence est entièrement paramétrée. L'agent remplit un seul 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'image
│ │
└──────────► scripts/compose.ts ◄────────────┘
│
▼
<out>/index.html (autonome)
<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 façon 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 statistiques + 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 (fond sombre + 2 cartes inclinées), témoignage (citation + 5 glyphes partenaires), CTA (ruban + pilule email).
- Pied de page avec 4 colonnes de liens + grand mot d'accroche italique-serif.
- Animation scroll-reveal 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 marque
Utilisez AskQuestion (ou l'équivalent dans votre interface) pour recueillir le brief de marque par morceaux ; ne déversez pas l'intégralité du schema.ts sur l'utilisateur. Mappez leurs réponses dans inputs.json en respectant 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 = un seul glyphe (Ø, ▲, ★…) |
| 2 | brand.{license,version,year,primary_url,contact_email} | 4 | URL obligatoire ; license par défaut Apache-2.0 |
| 3 | nav[] (jusqu'à 5) | 3 | Badges de comptage optionnels |
| 4 | hero.{label,headline,lead,primary,secondary,stats} | Tous | Headline en MixedText (sans+em+dot) |
| 5 | about + capabilities.cards[4] | Tous | 4 cartes × {num,tag,title,body} |
| 6 | labs.cards[5] + method.steps[4] | Tous | Les deux grilles à arité fixe |
| 7 | work.cards[2] + testimonial | Tous | 5 glyphes partenaires sous forme de données de chemin SVG en ligne |
| 8 | cta + footer.{columns[4],mega} | Tous | Mega kicker est un MixedText comme les titres |
Ouvrez inputs.example.json pour un exemple complet (Open Design lui-même).
2. Décider la stratégie d'image
| Stratégie | Quand choisir | Coût / latence |
|---|---|---|
placeholder | Premier passage. Démo. Diapositive interne. Pas encore de budget image. | 0 $, <1s |
generate | Livraison finale. La marque veut des collages originaux. | ~0,40 $, ~6 min |
bring-your-own | L'utilisateur a des PNG 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 alias .png pour compatibilité) dans <out>/assets/. Chaque placeholder montre l'identifiant de l'emplacement, le ratio, les dimensions en pixels et l'indice de prompt du image-manifest.json. Les <img src='./assets/hero.png'> du compositeur fonctionnent 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 prompts comme suit : ancrage de style (système éditorial collage-papier) + variables de marque (nom / nav / titre / accentuation italique extraits de inputs.json) + composition par emplacement (par exemple tête en plâtre découpé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 imprime les prompts afin que l'opérateur puisse les acheminer via la commande slash /gpt-image-fal manuellement.
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 autonome. La page inclut :
- La feuille de style Atelier Zero complète, intégrée en ligne.
- Tout le balisage des sections avec les attributs
data-revealpour l'animation scroll décalée. - Le script IntersectionObserver en ligne (reflète
apps/landing-page/app/_components/reveal-root.tsx). - Le script de navigation Headroom en ligne (reflète
header.tsx). - Le récupérateur de compteur d'étoiles GitHub en ligne (détection automatique depuis
brand.primary_url).
4. (Optionnel) Mettre en miroir le 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. Construisez avec pnpm --filter @open-design/landing-page build pour une exportation statique out/ prête pour n'importe quel CDN.
Une itération future pourrait regrouper un compositeur qui émet l'arborescence complète
apps/landing-page/à partir deinputs.jsonen une seule commande. D'ici là, le fork et l'édition sont la voie prise 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 de console. - Les 16 emplacements d'image se chargent (pas de 404 dans l'onglet réseau DevTools).
- Les plages d'accentuation italique des titres s'affichent en Playfair (pas en sans).
- Les points terminaux corail apparaissent à la fin de chaque h1/h2 d'affichage.
- Défilement de haut en bas ; chaque section s'anime une fois.
- Redimensionnez à 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 d'affichage des polices, aucun décalage de mise en page sur le héros (CLS < 0,05).
Fichiers de cette compétence
skills/open-design-landing/
├── SKILL.md # ce contrat
├── README.md # démarrage rapide
├── schema.ts # entrées typées (source unique de vérité)
├── styles.css # feuille de style Atelier Zero (source unique de vérité)
├── inputs.example.json # Open Design comme exemple complet
├── example.html # rendu canonique (régénéré à partir de 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 # correspondance emplacement → fichier/dimensions/prompt
└── imagegen-prompts.md # paquet de prompts lisible par l'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 donne une sensation de mort. - N'enveloppez pas le HTML composé dans un framework qui injecte son propre ordre de feuille de style — Atelier Zero dépend de la cascade d'ordre de la feuille de style pour la texture du papier et l'indice z des rails latéraux.
- N'ajoutez pas de fichier de feuille de style séparé pour le fork Astro de la page d'accueil ; copiez
styles.csstextuellement dansapp/globals.csspour que la parité visuelle reste un pour un.
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/— compétence de diapositives sœur qui réutilise ce système de design.
