Communitygithub.com

open-design-landing

Erstelle eine einseitige, redaktionelle Landingpage im Atelier Zero Designsystem – mit Collagen, Scroll-Animationen und einem Headroom-Navigationsbalken.

Was ist open-design-landing?

Diese Skill-Anleitung beschreibt, wie eine redaktionelle Landingpage im Atelier Zero Designsystem erstellt wird – einem warmen, paper-texturierten Stil mit Schriftarten Inter Tight und Playfair Display, kursiven Serifen-Hervorhebungen, gepunkteten Linien und korallenfarbenen Abschlusspunkten. Der Agent füllt dabei ein typisiertes `inputs.json` aus den Nutzerangaben, entscheidet über die Bildstrategie (Platzhalter, KI-generierte Collagen via gpt-image-2 oder eigene PNGs) und führt einen Composer aus, der eine eigenständige HTML-Datei mit vollständigem Styling, Scroll-Reveal-Animationen und Headroom-Navigation erzeugt. Optional kann der Inhalt in das Astro-Frontend unter `apps/landing-page/` gespiegelt werden. Die Anleitung definiert einen strikten Workflow mit acht Fragegruppen, einer Selbstprüfliste zur Qualitätssicherung und klaren Grenzen – etwa, dass keine neuen Farben oder Schriften erfunden werden dürfen. Die Ausgabe ist eine einzige HTML-Datei, die sich direkt deployen lässt und auf jedem Endgerät responsiv ist.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Vorschau

Aus dem Skill-README

open-design-landing preview

Dokumentation

Was macht open-design-landing?

Erstelle eine einseitige redaktionelle Landingpage (oder eine Slide-Deck-Präsentation – siehe die verwandte Skill open-design-landing-deck) im Atelier Zero Designsystem: warmer Papierhintergrund, Inter Tight + Playfair Display, kursive Serifen-Hervorhebungen, gepunktete Linien, korallenfarbene Abschlusspunkte, Scroll-Reveal-Animationen und 16 surreale Collage-Bildtafeln.

Dies ist das kanonische Rezept für die OpenDesign-Marketing-Seite – das Beispiel-Output ist genau die Seite, die Sie unter open-design sehen.

Die Skill ist vollständig parametrisiert. Der Agent füllt eine typisierte inputs.json aus den Nutzerangaben; der Composer wandelt dieses JSON zusammen mit dem kanonischen styles.css in ein deploybares 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 allem folgenden:

  • Redaktionelle Top-Leiste (Volume / Issue / Language-Streifen), Headroom-Sticky-Nav mit live GitHub-Sternanzahl.
  • 8 nummerierte römisch-ziffern-Abschnitte mit papiertexturiertem Hintergrund: Hero (mit 3 Stat-Ringen + 4-Schritte-Index), About, Capabilities (4 Karten), Labs (5 Karten + Filter-Pills + Fortschrittsbalken), Method (4 Schritte mit Miniaturen), Selected Work (dunkle Platte + 2 geneigte Karten), Testimonial (Pull-Zitat + 5 Partner-Glyphen), CTA (Band + E-Mail-Pille).
  • Footer mit 4 Link-Spalten + großem kursivem Serifen-Kicker-Wort.
  • Scroll-Reveal-Animation auf jedem Abschnitt (IntersectionObserver, respektiert prefers-reduced-motion).
  • Vollständig responsiv bei 1280 / 1080 / 880 / 560 Breakpoints.

Workflow-Vertrag

Führen Sie diese vier Schritte nacheinander aus. Der Agent sollte jeden Schritt abschließen, bevor er zum nächsten übergeht, und dem Nutzer lieber eine gezielte Frage stellen, als selbst Texte zu erfinden.

1. Marken-Inputs sammeln

Verwenden Sie AskQuestion (oder das entsprechende UI-Element), um das Brand-Brief in Teilen zu erfragen; geben Sie nicht das gesamte schema.ts auf einmal aus. Übersetzen Sie die Antworten in inputs.json, das der typisierten Struktur entspricht.

Die acht Fragegruppen in Reihenfolge:

GruppeSchema-FelderMin. AntwortenHinweise
1brand.{name,mark,tagline,description,location}5Mark = einzelnes Glyph (Ø, ▲, ★…)
2brand.{license,version,year,primary_url,contact_email}4URL ist erforderlich; Lizenz standardmäßig Apache-2.0
3nav[] (bis zu 5)3Optionale Zähl-Badges
4hero.{label,headline,lead,primary,secondary,stats}AlleHeadline als MixedText (sans+em+dot)
5about + capabilities.cards[4]Alle4 Karten × {num,tag,title,body}
6labs.cards[5] + method.steps[4]AlleBeide Grids mit fester Anzahl
7work.cards[2] + testimonialAlle5 Partner-Glyphen als Inline-SVG-Pfaddaten
8cta + footer.{columns[4],mega}AlleMega Kicker ist ein MixedText wie die Headlines

Öffnen Sie inputs.example.json für ein vollständiges Beispiel (OpenDesign selbst).

2. Die Bildstrategie festlegen

StrategieWann wählenKosten / Latenz
placeholderErster Durchlauf. Demo. Interne Präsentation. Noch kein Bild-Budget.$0, <1s
generateFinale Auslieferung. Marke möchte originale Collagen.~$0,40, ~6 min
bring-your-ownNutzer hat Art-Direction-PNGs. Legen Sie sie unter assets_path ab.$0, 0s

Setzen Sie inputs.imagery.strategy entsprechend.

placeholder – Rahmenmodus

npx tsx scripts/placeholder.ts <out>/assets/

Schreibt 16 .svg-Dateien (mit .png-Aliases für Kompatibilität) nach <out>/assets/. Jeder Platzhalter zeigt die Slot-ID, das Verhältnis, die Pixelmaße und den Prompt-Hinweis aus image-manifest.json. Die <img src='./assets/hero.png'>-Verweise des Composers 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 als: Stilanker (Papier-Collage-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; --force zum Neu-Rendern.

Ohne FAL_KEY gibt das Skript die Prompts aus, sodass der Bediener sie manuell über den /gpt-image-fal Slash-Command-Skill ausführen 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 Composer liest inputs.json und ../styles.css und schreibt eine eigenständige HTML-Datei. Die Seite enthält:

  • Das vollständige Atelier Zero Stylesheet, inline.
  • Das gesamte Abschnitts-Markup mit data-reveal-Attributen für gestaffelte Scroll-Animationen.
  • Inline IntersectionObserver-Skript (spiegelt apps/landing-page/app/_components/reveal-root.tsx).
  • Inline Headroom-Nav-Skript (spiegelt header.tsx).
  • Inline GitHub-Sternanzahl-Abrufer (erkennt automatisch die URL aus brand.primary_url).

4. (Optional) Das deploybare Astro-Site spiegeln

Für deploybare Produktionsausgabe forken Sie das apps/landing-page/ Paket: kopieren Sie es in Ihren Workspace, gleichen Sie app/page.tsx mit dem Inhalt aus 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 Composer bündeln, der den gesamten apps/landing-page/-Baum in einem Befehl aus inputs.json erzeugt. Bis dahin ist Fork-and-Edit der unterstützte Weg.


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 404er im DevTools-Netzwerk-Tab).
  • Kursive Headline-Hervorhebungen werden in Playfair (nicht sans) gerendert.
  • Korallenfarbene Abschlusspunkte erscheinen am Ende jeder display h1/h2.
  • Von oben nach unten scrollen; jeder Abschnitt animiert einmal ein.
  • Auf 880px und 560px zoomen; kein horizontaler Scroll, 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 dieser Skill

design-templates/open-design-landing/
├── SKILL.md                 # dieser Vertrag
├── README.md                # Schnellstart
├── schema.ts                # typisierte Inputs (Single Source of Truth)
├── styles.css               # Atelier Zero Stylesheet (Single Source of Truth)
├── inputs.example.json      # OpenDesign als Arbeitsbeispiel
├── example.html             # kanonisches Rendering (regeneriert aus inputs.example.json)
├── scripts/
│   ├── compose.ts           # inputs.json + styles.css → index.html
│   ├── imagegen.ts          # gpt-image-2 Wrapper (fal.ai)
│   └── placeholder.ts       # SVG-Papiertextur-Rahmen
└── assets/
    ├── *.png                # 16 Collage-Platten (OpenDesign-Instanz)
    ├── image-manifest.json  # Slot → Datei/Maße/Prompt-Zuordnung
    └── imagegen-prompts.md  # Menschlich lesbares 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 Rampe hinzufügen.
  • Entfernen Sie keine data-reveal-Attribute aus dem generierten Markup. Ohne sie bleibt die Seite statisch und wirkt leblos.
  • Wickeln Sie das komponierte HTML nicht in ein Framework, das eine eigene Stylesheet-Reihenfolge einfügt – Atelier Zero verlässt sich auf die Kaskade der Stylesheet-Reihenfolge für Papierstruktur und z-index der Seitenleisten.
  • Fügen Sie keine separate Stylesheet-Datei für den Astro-Landingpage-Fork hinzu; kopieren Sie styles.css wortwörtlich in app/globals.css, damit die visuelle Übereinstimmung eins zu eins bleibt.

Siehe auch

Individual skills in this repo

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

Verwandte Skills