Que fait open-design-landing ?
Construisez un site vitrine éditorial sur une seule page (ou un jeu 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, emphases en italique serif, règles pointillées, points terminaux corail, animation de dévoilement au défilement et 16 plaques de collage surréalistes.
C'est la recette canonique des pages 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 inputs.json typé à partir du brief de l'utilisateur ; le compositeur transforme ce JSON + la styles.css canonique en un artefact déployable.
inputs.json + styles.css 16 emplacements d'images
│ │
└──────────► scripts/compose.ts ◄────────────┘
│
▼
<out>/index.html (autonome)
<out>/assets/ (PNG ou SVG)
Ce que vous obtenez
Un seul fichier HTML avec tout ceci :
- Barre éditoriale supérieure (volume / numéro / langue), navigation collante de type Headroom avec compteur d'étoiles GitHub live.
- 8 sections numérotées en chiffres romains avec fond texturé papier : héro (avec 3 anneaux de statistiques + index en 4 étapes), à propos, capacités (4 cartes), laboratoires (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 + grand mot de conclusion en italique serif.
- Animation de dévoilement 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. Recueillir les informations de la marque
Utilisez AskQuestion (ou l'équivalent dans votre interface) pour recueillir le brief de la 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 forme 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 est requis ; 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 de taille fixe |
| 7 | work.cards[2] + testimonial | Tous | 5 glyphes partenaires en données de chemin SVG en ligne |
| 8 | cta + footer.{columns[4],mega} | Tous | Mega kicker est un MixedText comme les headlines |
Ouvrez inputs.example.json pour un exemple complet (Open Design lui-même).
2. Décider la stratégie d'images
| Stratégie | Quand choisir | Coût / latence |
|---|---|---|
placeholder | Première passe. Démo. Présentation interne. Pas encore de budget images. | 0 $, <1s |
generate | Livraison finale. La marque veut des collages originaux. | ~0,40 $, ~6 min |
bring-your-own | L'utilisateur a des PNG avec 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 montre l'identifiant de l'emplacement, le ratio, les dimensions en pixels et l'indice de prompt issu de image-manifest.json. Les balises <img src='./assets/hero.png'> du compositeur fonctionnent simplement.
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 stylistique (système éditorial collage papier) + variables de marque (nom / navigation / headline / emphase italique extraites de inputs.json) + composition par emplacement (par exemple, 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 re-rendre.
Sans FAL_KEY, le script imprime les prompts afin que l'opérateur puisse les router manuellement via la compétence slash /gpt-image-fal.
bring-your-own
Déposez 16 PNG correspondant aux noms de fichiers de assets/image-manifest.json dans inputs.imagery.assets_path. Fini.
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 complète d'Atelier Zero, inline.
- Tout le balisage des sections avec des attributs
data-revealpour un mouvement de défilement échelonné. - Script IntersectionObserver inline (reflète
apps/landing-page/app/_components/reveal-root.tsx). - Script de navigation Headroom inline (reflète
header.tsx). - Récupérateur de compteur d'étoiles GitHub inline (détecte automatiquement depuis
brand.primary_url).
4. (Optionnel) Refléter 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 de
apps/landing-page/à partir deinputs.jsonen une seule commande. En attendant, le fork-édition est le chemin pris en charge.
Vérification avant livraison
Avant de marquer la tâche comme terminée, l'agent doit vérifier :
-
<out>/index.htmls'ouvre dans un navigateur sans erreurs de console. - Les 16 emplacements d'images se chargent (pas de 404 dans l'onglet réseau des DevTools).
- Les emphases en italique des headlines s'affichent en Playfair (pas en sans).
- Les points terminaux corail apparaissent à chaque fin de
displayh1/h2. - Défilez du haut vers le bas ; chaque section s'anime une fois.
- Redimensionnez à 880px et 560px ; pas de défilement horizontal, pas de chevauchement.
-
prefers-reduced-motion: reduce(DevTools → Rendering) désactive proprement les transitions. - Lighthouse : contraste AA, affichage des fontes en swap, pas de décalage de mise en page sur le héro (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 concret
├── 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 plaques de collage (instance Open Design)
├── image-manifest.json # mappage emplacement → fichier/dimensions/prompt
└── imagegen-prompts.md # pack de prompts humainement lisibles
Limites
- Ne pas inventer de nouvelles couleurs ou polices. Les jetons vivent dans
design-systems/atelier-zero/DESIGN.md; étendez le système de design avant d'ajouter une nouvelle rampe ici. - Ne pas supprimer les attributs
data-revealdu balisage généré. Sans eux, la page devient statique et semble morte. - Ne pas envelopper le HTML composé dans un framework qui injecte son propre ordre de feuilles de style — Atelier Zero repose sur la cascade de l'ordre des feuilles de style pour la texture du papier et le z-index des rails latéraux.
- Ne pas ajouter un fichier de feuille de style séparé pour le fork de la page d'atterrissage Astro ; copiez
styles.csstextuellement dansapp/globals.cssafin 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/— compétence sœur de diapositives qui réutilise ce système de design.
