Was macht open-design-landing?
Erstellt eine einseitige redaktionelle Landingpage (oder eine Präsentation – siehe das verwandte Skill open-design-landing-deck) im Atelier Zero-Designsystem: warmer Papierhintergrund, Inter Tight + Playfair Display, kursive Serifen-Hervorhebungen, gepunktete Haarstriche, korallenfarbene Abschlusspunkte, Scroll-Reveal-Animationen und 16 surreale Collage-Tafeln.
Dies ist das kanonische Rezept für die Open Design-Marketingseite – das Beispiel-Output ist genau die Seite, die Sie unter open-design sehen.
Das Skill ist vollständig parametrisiert. Der Agent füllt eine einzige typisierte inputs.json aus der Benutzerbeschreibung; der Komponist wandelt dieses JSON + das kanonische styles.css in ein einsatzbereites Artefakt um.
inputs.json + styles.css 16 Bild-Slots
│ │
└──────────► scripts/compose.ts ◄────────────┘
│
▼
<out>/index.html (eigenständig)
<out>/assets/ (PNG oder SVG)
Was Sie erhalten
Eine einzelne HTML-Datei mit allen folgenden Elementen:
- Redaktionelle Leiste (Band / Ausgabe / Sprachstreifen), Headroom-artige sticky Navigation mit Live-GitHub-Sternanzahl.
- 8 nummerierte römische Abschnitte mit Papierstruktur-Hintergrund: Hero (mit 3 Statistikringen + 4-stufigem Index), Über uns, Fähigkeiten (4 Karten), Labs (5 Karten + Filter-Pills + Fortschrittsbalken), Methode (4 Schritte mit Vorschaubildern), Ausgewählte Arbeiten (dunkle Platte + 2 geneigte Karten), Testimonial (Zitat + 5 Partner-Glyphen), CTA (Band + E-Mail-Pille).
- Fußzeile mit 4 Link-Spalten + großem kursivem Serifen-Kicker-Wort.
- Scroll-Reveal-Animationen in jedem Abschnitt (IntersectionObserver, respektiert
prefers-reduced-motion). - Vollständig responsiv bei 1280 / 1080 / 880 / 560 Breakpoints.
Workflow-Vertrag
Führen Sie diese vier Schritte in der Reihenfolge aus. Der Agent sollte jeden Schritt abschließen, bevor er zum nächsten übergeht, und es vorziehen, dem Benutzer eine gezielte Frage zu stellen, anstatt Texte zu erfinden.
1. Markeneingaben sammeln
Verwenden Sie AskQuestion (oder das Äquivalent in Ihrer UI), um die Markenbeschreibung in Abschnitten zu sammeln; geben Sie dem Benutzer nicht die gesamte schema.ts auf einmal. Ordnen Sie die Antworten in inputs.json entsprechend der typisierten Struktur zu.
Die acht Fragengruppen in der Reihenfolge:
| Gruppe | Schema-Felder | Min. Antworten | Hinweise |
|---|---|---|---|
| 1 | brand.{name,mark,tagline,description,location} | 5 | Mark = einzelnes Glyph (Ø, ▲, ★…) |
| 2 | brand.{license,version,year,primary_url,contact_email} | 4 | URL ist erforderlich; Lizenz standardmäßig Apache-2.0 |
| 3 | nav[] (bis zu 5) | 3 | Optionale Zähl-Badges |
| 4 | hero.{label,headline,lead,primary,secondary,stats} | Alle | Headline als MixedText (sans+em+dot) |
| 5 | about + capabilities.cards[4] | Alle | 4 Karten × {num,tag,title,body} |
| 6 | labs.cards[5] + method.steps[4] | Alle | Beide Grids mit fester Anzahl |
| 7 | work.cards[2] + testimonial | Alle | 5 Partner-Glyphen als Inline-SVG-Pfaddaten |
| 8 | cta + footer.{columns[4],mega} | Alle | Mega-Kicker ist ein MixedText wie die Headlines |
Öffnen Sie inputs.example.json für ein vollständiges Arbeitsbeispiel (Open Design selbst).
2. Bildstrategie festlegen
| Strategie | Wann wählen | Kosten / Latenz |
|---|---|---|
placeholder | Erster Durchlauf. Demo. Interne Präsentation. Noch kein Bildbudget. | 0 $, <1s |
generate | Endauslieferung. Marke wünscht Originalcollagen. | ~0,40 $, ~6 Min. |
bring-your-own | Benutzer hat gestaltete PNGs. Ablegen unter assets_path. | 0 $, 0s |
Setzen Sie inputs.imagery.strategy entsprechend.
placeholder — Frame-Modus
npx tsx scripts/placeholder.ts <out>/assets/
Schreibt 16 .svg-Dateien (mit .png-Aliasen für Kompatibilität) in <out>/assets/. Jeder Platzhalter zeigt die Slot-ID, das Seitenverhältnis, die Pixelmaße und den Prompt-Hinweis aus image-manifest.json. Die <img src='./assets/hero.png'> etc. des Komponisten funktionieren einfach.
generate — gpt-image-2-Modus
FAL_KEY=... npx tsx scripts/imagegen.ts <inputs.json> --out=<out>/assets/
Ruft den synchronen Endpunkt openai/gpt-image-2 von fal.ai pro Slot auf. Setzt Prompts zusammen aus: Stilanker (Papiercollage-redaktionelles System) + Markenvariablen (Name / Nav / Headline / kursive Hervorhebung aus inputs.json) + Pro-Slot-Komposition (z. B. beschnittener Gipskopf + Baum, der durch einen Bogen wächst). Überspringt Slots, deren Zieldatei bereits existiert; mit --force wird neu gerendert.
Ohne FAL_KEY gibt das Skript die Prompts aus, sodass der Bediener sie manuell über das /gpt-image-fal-Slash-Command-Skill leiten kann.
bring-your-own
Legen Sie 16 PNGs, die den Dateinamen aus assets/image-manifest.json entsprechen, unter inputs.imagery.assets_path ab. Fertig.
3. Das Artefakt komponieren
npx tsx scripts/compose.ts <inputs.json> <out>/index.html
Der Komponist liest inputs.json und ../styles.css und schreibt eine einzige eigenständige HTML-Datei. Die Seite enthält:
- Das vollständige Atelier Zero-Stylesheet, inline eingebunden.
- Das gesamte Abschnitts-Markup mit
data-reveal-Attributen für gestaffelte Scroll-Animationen. - Ein Inline-IntersectionObserver-Skript (Spiegel von
apps/landing-page/app/_components/reveal-root.tsx). - Ein Inline-Headroom-Navigationsskript (Spiegel von
header.tsx). - Einen Inline-GitHub-Sternanzahl-Abruf (erkennt automatisch aus
brand.primary_url).
4. (Optional) Die einsetzbare Astro-Seite spiegeln
Für einsetzbare Produktionsausgabe: Forken Sie das apps/landing-page/-Paket: kopieren Sie es in Ihren Arbeitsbereich, gleichen Sie app/page.tsx mit dem Inhalt Ihrer inputs.json ab und kopieren Sie Ihre <out>/assets/*.png in die Pfade, die von app/image-assets.ts / R2-URLs erwartet werden. Bauen Sie mit pnpm --filter @open-design/landing-page build für einen statischen out/-Export, der für jedes CDN bereit ist.
Eine zukünftige Iteration könnte einen Komponisten bündeln, der den vollständigen
apps/landing-page/-Baum ausinputs.jsonin einem Befehl erstellt. Bis dahin ist Fork-and-Edit der unterstützte Pfad.
Selbstprüfung vor der Auslieferung
Bevor der Agent die Aufgabe als erledigt markiert, muss er Folgendes überprüfen:
-
<out>/index.htmlöffnet sich im Browser ohne Konsolenfehler. - Alle 16 Bild-Slots laden (keine 404 im DevTools-Netzwerk-Tab).
- Kursive Serifen-Hervorhebungen in Headlines werden in Playfair dargestellt (nicht Sans).
- Korallenfarbene Abschlusspunkte erscheinen an jedem
displayh1/h2-Ende. - Von oben nach unten scrollen; jeder Abschnitt animiert einmal herein.
- Auf 880px und 560px zoomen; kein horizontales Scrollen, keine Überlappungen.
-
prefers-reduced-motion: reduce(DevTools → Rendering) deaktiviert Übergänge sauber. - Lighthouse: Kontrast AA, font-display swap, kein Layout-Shift im Hero (CLS < 0.05).
Dateien in diesem Skill
skills/open-design-landing/
├── SKILL.md # dieser Vertrag
├── README.md # Schnellstart
├── schema.ts # typisierte Eingaben (Single Source of Truth)
├── styles.css # Atelier Zero-Stylesheet (Single Source of Truth)
├── inputs.example.json # Open Design als Arbeitsbeispiel
├── example.html # kanonische Darstellung (neu generiert aus inputs.example.json)
├── scripts/
│ ├── compose.ts # inputs.json + styles.css → index.html
│ ├── imagegen.ts # gpt-image-2-Wrapper (fal.ai)
│ └── placeholder.ts # SVG-Papierstruktur-Frames
└── assets/
├── *.png # 16 Collage-Tafeln (Open Design-Instanz)
├── image-manifest.json # Slot → Datei/Maße/Prompt-Zuordnung
└── imagegen-prompts.md # menschenlesbares Prompt-Paket
Grenzen
- Erfinden Sie keine neuen Farben oder Schriftarten. Tokens leben in
design-systems/atelier-zero/DESIGN.md; erweitern Sie das Designsystem, bevor Sie hier eine neue Stufe hinzufügen. - Entfernen Sie keine
data-reveal-Attribute aus dem generierten Markup. Ohne sie wird die Seite statisch und fühlt sich tot an. - Verpacken Sie das komponierte HTML nicht in ein Framework, das seine eigene Stylesheet-Reihenfolge einfügt — Atelier Zero verlässt sich auf die Stylesheet-Reihenfolge-Kaskade für die Papierstruktur und den z-index der Seitenleisten.
- Fügen Sie für den Astro-Landingpage-Fork keine separate Stylesheet-Datei hinzu; kopieren Sie
styles.cssunverändert inapp/globals.css, damit die visuelle Übereinstimmung eins zu eins bleibt.
Siehe auch
design-systems/atelier-zero/DESIGN.md— Token-Spezifikation.apps/landing-page/— einsetzbares Astro-Statik-Pendant.skills/open-design-landing-deck/— verwandtes Folien-Skill, das dieses Designsystem wiederverwendet.
