Communitygithub.com

open-design-landing

Construisez un site vitrine éditorial d'une seule page dans le langage visuel Atelier Zero (collage éditorial Monocle / Apartamento / Études) — la même esthétique qu'OpenDesign utilise pour sa propre surface marketing.

Qu'est-ce que open-design-landing ?

Cette compétence permet à un agent IA de générer un site d'atterrissage éditorial complet en une seule page HTML, dans le système de design **Atelier Zero**. L'agent orchestre un flux de travail en quatre étapes : 1) remplir un `inputs.json` typé à partir des réponses du brief utilisateur, 2) décider de la stratégie d'images (placeholders gratuits, génération par `gpt-image-2` via fal.ai pour environ 0,40 $, ou images fournies par l'utilisateur), 3) exécuter un compositeur pur qui produit un fichier `index.html` autonome avec animations scroll-reveal, navigation sticky Headroom, et barre de progression, et 4) éventuellement refléter le résultat dans un site Astro déployable (`apps/landing-page/`). Le design inclut une palette chaude (fond papier, polices Inter Tight + Playfair Display, accents italiques, règles à points corail) et 16 emplacements d'images de collage surréalistes. La compétence garantit que le résultat est responsive, accessible (préférence de mouvement réduite respectée), et prêt pour une revue Lighthouse (contraste AA, CLS < 0,05).

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/kelgirechandrakant-cpu/statsarthi/tree/HEAD/.agents/skills/open-design-landing

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Aperçu

Depuis le README du skill

open-design-landing preview

Documentation

Que fait open-design-landing ?

Construisez un site d'atterrissage éditorial d'une seule page (ou un diaporama — 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, empans d'emphase en italique serif, règles en pointillés corail, points de terminaison corail, animation au défilement et 16 planches de collage surréalistes.

Il s'agit de la recette canonique de la page marketing OpenDesign — 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 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  (autonome)
              <out>/assets/      (PNG ou SVG)

Ce que vous obtenez

Un seul fichier HTML avec tous les éléments suivants :

  • Barre supérieure éditoriale (volume / numéro / bandeau de langue), navigation sticky Headroom avec compteur d'étoiles GitHub en direct.
  • 8 sections numérotées en chiffres romains avec arrière-plan texturé papier : héros (avec 3 anneaux de stats + index en 4 étapes), à propos, capacités (4 cartes), labs (5 cartes + filtres à pilules + barre de progression), méthode (4 étapes avec vignettes), travaux sélectionnés (dalle sombre + 2 cartes inclinées), témoignage (citation en attrait + 5 glyphes partenaires), CTA (ruban + pilule e-mail).
  • Pied de page avec 4 colonnes de liens + grand mot-clé italique serif.
  • 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. Recueillir les entrées de marque

Utilisez AskQuestion (ou l'équivalent dans votre interface) pour collecter 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 selon la forme typée.

Les huit groupes de questions, dans l'ordre :

GroupeChamps du schémaRéponses minNotes
1brand.{name,mark,tagline,description,location}5Mark = glyphe unique (Ø, ▲, ★…)
2brand.{license,version,year,primary_url,contact_email}4URL obligatoire ; licence par défaut Apache-2.0
3nav[] (jusqu'à 5)3Badges de comptage optionnels
4hero.{label,headline,lead,primary,secondary,stats}TousHeadline en MixedText (sans+em+dot)
5about + capabilities.cards[4]Tous4 cartes × {num,tag,title,body}
6labs.cards[5] + method.steps[4]TousLes deux grilles à arité fixe
7work.cards[2] + testimonialTous5 glyphes partenaires en tant que données de chemin SVG en ligne
8cta + footer.{columns[4],mega}TousLe mot-clé mega est un MixedText comme les titres

Ouvrez inputs.example.json pour un exemple complet (OpenDesign lui-même).

2. Décider de la stratégie d'images

StratégieQuand choisirCoût / latence
placeholderPremier passage. Démo. Interne. Pas encore de budget image.0 €, <1s
generateLivraison finale. La marque veut des collages originaux.~0,40 €, ~6 min
bring-your-ownL'utilisateur a des PNG de direction artistique. Déposez-les à assets_path.0 €, 0s

Réglez 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 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'> etc. du compositeur fonctionnent directement.

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 par emplacement. Compose les prompts comme suit : ancre de style (système éditorial collage papier) + variables de marque (nom / nav / titre / emphase italique extraite de inputs.json) + composition par emplacement (par exemple, tête en plâtre recadrée + arbre traversant une arche). Ignore les emplacements dont le fichier cible existe déjà ; passez --force pour régénérer.

Sans FAL_KEY, le script affiche les prompts afin que l'opérateur puisse les acheminer manuellement via la compétence slash-command /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. 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 complète Atelier Zero, intégrée.
  • Tout le balisage des sections avec des attributs data-reveal pour un mouvement de défilement échelonné.
  • Script IntersectionObserver en ligne (miroir de apps/landing-page/app/_components/reveal-root.tsx).
  • Script de navigation Headroom en ligne (miroir de header.tsx).
  • Récupérateur de comptage d'étoiles GitHub en ligne (auto-détection à partir de 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. Compilez avec pnpm --filter @open-design/landing-page build pour un export statique out/ prêt pour n'importe quel CDN.

Une itération future pourrait fournir un compositeur qui génère l'arborescence complète apps/landing-page/ à partir de inputs.json en une seule commande. En attendant, la méthode fork-and-edit est la voie prise en charge.


Auto-vérification avant livraison

Avant de marquer comme terminé, l'agent doit vérifier :

  • <out>/index.html s'ouvre dans un navigateur sans erreur console.
  • Les 16 emplacements d'images se chargent (pas de 404 dans l'onglet réseau DevTools).
  • Les empan d'emphase en italique des titres s'affichent en Playfair (pas en sans).
  • Les points de terminaison corail apparaissent à chaque fin de h1/h2 d'affichage.
  • Défilez du 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 les transitions proprement.
  • Lighthouse : contraste AA, font-display: swap, aucun décalage de mise en page sur le héros (CLS < 0,05).

Fichiers dans cette compétence

design-templates/open-design-landing/
├── SKILL.md                 # ce contrat
├── README.md                # démarrage rapide
├── schema.ts                # entrées typées (source de vérité unique)
├── styles.css               # feuille de style Atelier Zero (source de vérité unique)
├── inputs.example.json      # OpenDesign 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 texturés papier SVG
└── assets/
    ├── *.png                # 16 planches de collage (instance OpenDesign)
    ├── image-manifest.json  # emplacement → mapping fichier/dimensions/prompt
    └── imagegen-prompts.md  # pack de prompts lisible par l'humain

Limites

  • N'inventez pas 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.
  • N'omettez pas les attributs data-reveal du balisage généré. Sans eux, la page devient statique et semble sans vie.
  • 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 des feuilles de style pour la texture papier et le z-index des rails latéraux.
  • N'ajoutez pas de fichier de feuille de style séparé pour le fork de la page d'atterrissage Astro ; copiez styles.css textuellement dans app/globals.css pour que la parité visuelle reste un pour un.

Voir aussi

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Skills associés