Communitygithub.com

omd-landing

Scroll-native One-Page Landing, die überwältigt – Konzept, Komposition, Asset-Platzierung und Scroll-Choreografie basierend auf DESIGN.md und dem gemessenen Landing-Craft-Codex. Auslöser: '랜딩 페이지', '원페이지', 'landing page', 'one-pager', 'hero to footer', '스크롤 랜딩', 'affinity.studio 같은'.

Was ist omd-landing?

Diese Fähigkeit (`omd-landing`) erstellt eine vollständige, eigenständige One-Page-Landingpage, die den Besucher durch durchdachte Scroll-Choreografie visuell überwältigt. Sie ist für Entwickler und KI-Agenten (Claude Code, Cursor, Codex) konzipiert, die hochwertige, markengetreue Landingpages auf Basis eines Design-Briefings (`DESIGN.md`) und eines detaillierten Codex (`landing-craft-codex.md`) generieren müssen. Die Fähigkeit arbeitet in klar definierten Schritten: Konzeptfindung durch einen Art Director, Erstellung eines Storyboards mit 6–8 Sektionen und Dichte-Budget, Asset-Generierung (Bilder, Inline-SVGs, potenziell Video), HTML-Rendering (`render.html`) und eine mehrstufige Qualitätssicherung (Selbstbewertungs-Loop mit Tools wie `render-integrity`, `landing-integrity`, `text-contrast` und einer Designer-Review). Das Ergebnis ist eine pixelgenaue, responsive (1440/390), zugängliche (Contrast, Keyboard, Reduced Motion) und vollständig isolierte Datei ohne externe Abhängigkeiten.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/nococn/omd-landing/tree/HEAD

In Ihrer bevorzugten KI fragen

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

Dokumentation

omd:landing — Überwältigende One-Page

Eine Seite, die den Besucher durch Scrollen überwältigt. Nicht durch das Aneinanderreihen von Kartenrastern, sondern durch ein einziges visuelles Konzept, das im Hero geboren wird, in jedem Abschnitt in einer anderen Komposition variiert und im CTA schließt. Die Markengrundlage ist das Projekt DESIGN.md, die Kompositionsbeobachtungen stammen aus dem Landing-Craft-Codex (Regel-ID LC-n), die Produkthandlungen und lokalen Entscheidungsbefugnisse aus dem Brief. Codex-Pfad — Repo: docs/design-excellence/landing-craft-codex.md · Installiert: node_modules/oh-my-design-cli/docs/design-excellence/landing-craft-codex.md (Wenn beide fehlen, verwende node -p "require('path').dirname(require.resolve('oh-my-design-cli/package.json'))", um das Paket-Root zu finden und lies darunter docs/design-excellence/. Wenn keines gelesen wurde, starte nicht.

Eingabe

  1. Vollständiger DESIGN.md Text (bei Core v2 die Anker §Scope·Foundations·Components·Content·Motion, bei Legacy alle Abschnitte). Nur die hier vorhandenen Token verwenden — keine Erfindung. Pending aus .omd/preferences.md überschreibt DESIGN.md.
  2. Mindestens eine Brief-Zeile: Was der Besucher fühlen soll + welche Handlung er ausführen soll. Fehlt diese, wird sie in einem Batch von Fragen (max. 5) eingeholt. Im unbeaufsichtigten Modus (unattended) wird die erste Option jeder Frage ausgewählt und in trace.md als autoSelected vermerkt.
  3. Codex landing-craft-codex.md — die Regel-Tabelle direkt lesen und die in diesem Run anzuwendenden Regel-IDs auswählen und im Storyboard notieren.

Run-Verzeichnis (zuerst erstellen)

SLUG=$(printf '%s' "<brand-oder-brief>" | tr '[:upper:] ' '[:lower:]-' | tr -cd 'a-z0-9-' | cut -c1-40)
RUN=.omd/runs/landing-$SLUG-$(date +%Y%m%d-%H%M)
mkdir -p "$RUN/assets" && printf '%s\n' "<Brief-Originaltext>" > "$RUN/task.md"

<run> = obiges $RUN. Alle Ergebnisse werden nur in dieses Verzeichnis geschrieben (wie omd-harness Konvention, eine Zeile an .omd/runs/INDEX.md anhängen).

Ausgabe (nur im Run-Verzeichnis)

<run>/
  concept.md        Art Director Ausgabe — Konzept-Satz, Stimmung, Palettennutzung, Asset-Richtung, Verbotsliste
  storyboard.md     Sektionstabelle: Reihenfolge·Zweck·Viewporthöhe·Komposition(LC-n)·Asset-Plan(Prompt)·Scroll-Inszenierung·Copy-Gerüst
  assets/           Generierte Bilder (omd:media Kanal) + Inline SVG Quellen
  render.html       Eigenständige Datei (0 externe Requests), 1440·390 reaktiv, IntersectionObserver Reveal, pinned ≤1, reduced-motion
  system.md         Beschreibung des Design-Systems dieser Seite (mit Token-Referenzpfaden)
  loop-trace.json   Selbstbewertung: Iterationen mit Fehleranzahl (render-integrity·landing-integrity·designer-review), autoSelected
  trace.md          Bild-Prompt-Originale, Kanal, Kosten, sha256, Wiederholungen

Verfahren

1. Konzept (Agent omd-art-director)

Aus den Markenfakten des DESIGN.md (§1 Narrativ·§Principles·§Voice) und dem Brief einen Konzept-Satz extrahieren. Das Konzept ist keine Aneinanderreihung von Adjektiven, sondern beschreibt, was die Seite "zeigt" (z.B. "Die Bezahlung als Rohrquerschnitt betrachten"). Der Art Director schreibt Konzept, Stimmung, Asset-Richtung und Verbote (Anti-Pattern aus dem Codex + Vercel-artige „generated-design reflexes") in concept.md. Vor dem Build Anwendungsbereichstabelle in derselben Datei: Entscheidung | Begründungsart (Markenfakt/autorisierte Projektsentscheidung/Codex-Beobachtung) | Quelle·betroffene Surface | Diese Anwendung/ungeklärter Grund | Verifikationsmethode. Die flache Beobachtung eines öffentlichen Controls ist der Beweis für dieses Control, nicht die Begründung, alle Landing-Objekte, 3D und Beleuchtung zu verbieten. Keine lokale Szenenregie zu Unternehmensfakten aufwerten, keine unbestätigten Token erfinden. Wenn Quelle und Ziel unterschiedlich sind, als Prüfgrund belassen. Bereits im Aufruf-Prompt vorhandene Assets verbal beschreiben und übergeben (Motiv·Komposition·Hauptfarbe·Position des Leerraums, Pixelgröße mit sips -g pixelWidth -g pixelHeight). Der Art Director öffnet keine Bilddateien mit Read — es gab einen Fall, in dem die Session nach einem großen Bild tool_result stecken blieb (Dogfooding 2026-09-02).

2. Storyboard

6–8 Sektionen. Jede Sektion enthält: (a) Zweck-Satz, (b) Viewporthöhe (unter Verweis auf die Sektions-Rhythmus-Regel des Codex), (c) Kompositionsmuster — Muster-Name und LC-n aus der Codex-Tabelle (bleed / inset / stacked / split / pinned-reveal …), (d) Asset-Plan — Art (Foto/Render/Illustration/abstrakte UI)·aufzuklärender Produktzustand/Bedeutung·Verhältnis·Platzierung·Ziel-Belegungsfläche des Motivs·Generierungs-Prompt-Originaltext (Markenfarben-Hex im Prompt verankern), (e) Scroll-Inszenierung (Reveal-Art, Dauer·Easing aus den DESIGN.md Motion-Token), (f) Copy-Gerüst. Einen Überwältigungspunkt festlegen — die Sektion, in der die Seite ihren Höhepunkt erreicht, und die leere Sektion unmittelbar davor.

Dichte-Budget (numerisch angeben — nur Beschreibung führt zu leeren Seiten)

Anzahl und Verhältnis allein beweisen noch keine bedeutungsvolle Szene. Die folgenden Zahlen einhalten, gleichzeitig für jedes Asset planen, welchen Produktzustand/welche Bedeutung es aufklärt, und die tatsächliche Belegungsfläche des Motivs (nicht des Containers) planen und im Rendering überprüfen. Keine sich wiederholenden SVGs nur zum Auffüllen, keine zugeschnittenen/vergrößerten Versionen desselben leeren Blattes, keine bedeutungslosen Satellitenbilder.

Grenze zu omd-restraint (LC-59 Dichte-Dial). Der folgende Boden gilt vollständig für Dial ≥ 6 (Showcase-Landing). Bei Dial ≤ 5 (Produkt·Katalog·Dokumentationsseite) gewinnt die Obergrenze von omd-restraint (erster Screen Fragmente ≤ 5, Schriftgröße ≤ 4, CTA ≤ 2 …). In beiden Fällen bleiben R1 (ein Fokus)·R2 (erster Screen Fragmente)·R10 (Fakt nur einmal) bestehen.

  • Media-Gesamtmenge ≥ Page vh × 1.0. Bei 12vh Page also ≥ 12 Media. Zähle Bilder, Videos, bedeutungsvolle Inline-SVGs (keine einzelnen Icons — nur solche ≥ 24px, die dekorativ sind, kein Inhalt).
  • Above the Fold (erster Screen) Media ≥ 3. Im Codex-Messung hatte affinity 8 im Fold.
  • Bei Verwendung eines Scrollers (LC-15) Items ≥ 8. Ein Horizontal-Scroll mit 3–4 Items ist kein Dichte-Ventil, sondern eine leere Zeile.
  • Motion-Asset ≥ 1. Wenn omd:setup einen Videokanal eingerichtet hat, mit image_to_video ein Sektions-Asset in eine 6-Sekunden-Schleife verwandeln. Bei prefers-reduced-motion durch ein Standbild desselben Frames ersetzen (autoplay·muted·loop·playsinline). Falls kein Kanal vorhanden, dies in trace.md notieren — nicht stillschweigend überspringen.
  • Tintenziel pro Sektion ≥ 26% (untere Grenze des gemessenen Bereichs 26–54%). Bei Unterschreitung Padding, Motivgröße, notwendige Zustandsdarstellungen anpassen.
  • Vertikales Padding nicht auf einen festen vh-Wert vereinheitlichen. Der erste Output hatte alle Sektionen gleich bei 18vh/24vh, dadurch kein Rhythmus (Median = Maximum = 378px). Bei Sektionen mit niedriger Dichte Padding reduzieren, große Abstände nur vor und nach dem Überwältigungspunkt.

3. Assets

Die Prompts aus dem Storyboard mit dem von omd:media erkannten Kanal ausführen (kein Kanal → Prompt-Paket und manuelle Warteschlange in assets/QUEUE.md hinterlegen, an deren Stelle abstrakte SVG-Placeholder aus der Markenfarbpalette setzen — keine Stock- oder Emoji-Verbote). Keine Gesichtsfotos generieren, keine Logos generieren (Text-Wordmarken). Jedes Bild mit Prompt·Kanal·Kosten in trace.md notieren. Fehlgeschlagene Generierungen je nach Ursache korrigieren, Kanallimit·Placeholder mit tatsächlicher Anzahl in trace.md notieren. Wenn eine einzige Originalszene den Zweck erfüllt, keine Duplikate erzeugen, sondern mit dieser Komposition den Review-Render erstellen. Dichte-Budget-Unterschreitung und roher checker FAIL bleiben so bestehen und werden an die Anwendungsbereichsprüfung übergeben. Review-Render-Erstellung ist keine Fertigstellung·waiver·PASS. Das Bildseitenverhältnis stammt aus dem tatsächlichen Seitenverhältnis des Slots, in den das Bild eingefügt wird (keine Standardwerte — omd:media §1).

4. Build

Eigenständiges render.html. CSS-Variablen verwenden die DESIGN.md Token-Namen direkt (--color-…, --space-…). UA-Standard-Stile zurücksetzen (figure/blockquote margins — #78). Bilder relativ zu assets/ oder als data URI. Motion nur über transform·opacity, Dauer max. 3 Stufen, alle bei @media (prefers-reduced-motion: reduce) anhalten. Maximale Textbreite·Type-Skala·Sektionshöhe innerhalb der Codex-Wertebereiche. Text auf Bildern benötigt eine Schrim (LC-36 "Überwältigung muss lesbar sein"): Hero·Pin-Phase·Inversions-Sektionen·Nav·Wordmark·Lead·CTA·Fokus-Ringe müssen den Hintergrundpixel-Kontrast WCAG 4.5:1 (Normal)·3:1 (Großer Text·UI) übersteigen, Mittel ist eine Alpha-Schrim (::before) in Token-Farbe und ein Fokus-Ring-Halo — der erste Toss-Run hatte ohne Schrim Nav 1.05:1·Wordmark 1.07:1, daher BLOCK 6. muted Token-Familie nicht für irgendeinen Fließtext verwenden, einschließlich Augenbrauen·rechtlicher Hinweise (3.0:1). Scroll-Reveal (opacity:0) bei <noscript> und @media (scripting: none) immer sichtbar — leere Seite ohne JS ist ein Fehler. Kontrast·Tastatur-Anforderungen und das Touch-Bedienbarkeitsziel dieser Fähigkeit sind keine beobachtete Markengeometrie. Wenn sie mit vorhandenen Token-Kombinationen nicht erfüllt werden können, notwendige lokale Entscheidungen im Anwendungsbereichs-Tabelle vorschlagen und die Autorisierungsgrenzen beachten. Keine Zugänglichkeitsfehler mit Markenkonsistenz entschuldigen.

5. Selbstbewertungs-Loop (max. 3 Iterationen — nach Abschluss aller Anwendungsprüfungen)

In Repos mit test-v2/tools/ den linken Pfad verwenden, sonst (installiertes Paket) die Befehle in Klammern omd — es sind dieselben Werkzeuge.

① node test-v2/tools/render-integrity.mjs <run>/render.html   (Installiert: omd check render <run>/render.html)      # Deterministisch
② node test-v2/tools/landing-integrity.mjs <run>/render.html  (Installiert: omd check landing <run>/render.html)     # Codex-Maschinenregeln
②′ node test-v2/tools/text-contrast.mjs <run>/render.html     (Installiert: omd check contrast <run>/render.html)    # Text auf Foto·Gradient·Fokus-Ring·no-JS (erste zwei Runs BLOCK-Reihe)
③ Tatsächliche Route Screenshots 1440·390: Vergleich jeder Sektionsgrenze und hero·peak·action·result Zustand mit Storyboard
③-b LI-24~26 Dichte-Boden (Screen-Tinte 12%·Fold-Media 3·Media 1/vh) Roh-Urteil und Anwendungsbereichsprüfung gemeinsam dokumentieren

④ `omd-designer-review` Sub-Agent starten (Agent, Eingabe: `<run>/render.html` absoluter Pfad + DESIGN.md Pfad + Tool-Call-Limit 20·15min·review.md Gerüst zuerst — nur BLOCK zählen)

③ endet nicht mit der Aufnahme allein. Der Implementierende überprüft die Bilder direkt: ob Titel·Motiv·betreffendes Control·Ergebnis im Frame sind. Große Sektionen nicht mit scrollIntoView-Zentrum-Crop als Sektionsanfang fehlinterpretieren. Viewport·Scroll-Position·Zustand·Output-Hash zusammenfassen, abgeschnittene Frames neu aufnehmen. Scroll-/Kamera-Reise auch mit tatsächlicher Eingabe überprüfen, Kontinuität nicht nur durch QA-Seek behaupten. Messmethode·Messwert der Motiv-Belegungsfläche pro Asset dokumentieren und mit dem Belegungsziel vergleichen. Wenn geschätzt, als Schätzung kennzeichnen.

Bei Seiten mit Aktionen die anwendbaren Elemente tatsächlich ausführen: empty → Inline-Fehler bei falscher Eingabe → correction → save → reload, Tastatur-Eintritt/Ausführung/Rückkehr, gerenderte Touch-Ziele ≥44×44 CSS px (Bedienbarkeitsziel dieser Fähigkeit, ausgenommen Inline-Links im Fließtext), no-JS·reduced-motion Alternativen. Fehler: Feldverbindung·focus·aria-invalid, Speicherergebnis: Inhalt und seine Persistenz überprüfen. Nicht anwendbare Elemente (z.B. Seiten ohne Speicherfunktion) mit Aufgabenbegründung dokumentieren, Entwickler-Zustands-Schalter nicht als Aktion verwenden.

Nur FAIL-Elemente korrigieren. In loop-trace.json die Fehler·Aktionsnachweise·Frame-Bestätigung·④BLOCK·nicht ausgeführte Elemente pro Tool protokollieren. Auch wenn nur ①② PASS sind, nicht auf Kontrast·Aktion·reale Anzeige·unabhängige Prüfung verzichten. Verifikation abgeschlossen erst, wenn alle anwendbaren Prüfungen abgeschlossen sind und keine ungelösten FAIL/BLOCK mehr existieren. Wenn Fehler nicht abnehmen oder dieselbe Regel-ID 2 mal hintereinander FAIL, Korrekturschleife abbrechen und als omd:issue erfassen. Abbruch ist kein Erfolg; nicht ausgeführte Prüfungen vermerken. Quellenkonflikt-Prüfung und Roh-Checker-Urteil getrennt erhalten, keine willkürlichen Waiver erstellen.

6. Vorführen

Mit omd:showcase <run>/render.html ein Scroll-Video (mp4/gif) erstellen (falls nicht vorhanden: test-v2/content-runs/build-scroll-compare.mjs Frame-Capture → ffmpeg). Unten das inoffizielle Hinweis sichtbar. Tatsächliches Eingabe-Video und Standbild-Montage unterscheiden. Verifikationsergebnis und visuelle Annahme durch den Benutzer getrennt berichten; keine ästhetische Zustimmung oder Annahme-Abschluss behaupten, bevor der Benutzer das Ergebnis angenommen hat.

Codex-Anwendungsübersicht (Vollständiger Codex; hier: welche Regeln in welcher Phase)

PhaseRegelnKernwerte (gemessen, 5 Sites)
Konzept·FoldLC-13, LC-3336Erster Screen Assets bedecken 89130% des Viewports, mind. 2 Seiten bleed; Überschrift oben 1/3 (17.639.7 %vh); linker Anker 5.4~14.4 %vw; Höhepunkt früh, mit Maß (vorherige Sektion Textanteil minimal → nächste Sektion maximal)
RhythmusLC-8~12, LC-14Page 1016 vh (ohne Pin-Fixierung); Text-Sektionen Median 1.01.9 vh; Pin-Phase exakt 1 Viewport; Reveal 0.1~6.8/Viewport je nach Dial; kein vertikales snap
Komposition·AbstandLC-4~74674% der Sektion sind Leerraum; Text 2.613.6% der Sektion; zwei Spuren (Bleed 1440 + Lesebereich 672/1232/1264); ein Gutter (48/88/92/104px) über die gesamte Seite
AssetsLC-17~20, §6 Tabelle2963 Bilder pro Seite·37 pro Sektion; Bleed-Assets 16:9; nur zwei Platzierungen: Bleed oder Inset (abgerundet, unterer Crop); Stock 0 — Produkt·Kundenarbeit
TypografieLC-21~25display:body 3.04.6× (bei Serife 7×); Body 1417px; UI-Skala 1.051.20, einmaliger Sprung an der Spitze 1.331.75; Gewichtskontrast gering (auch 300/300); nur lateinische Display −0.02em
Farbe·ÜbergangLC-26~28Ein Ground beibehalten (252 oder 12); Inversion nur eine Sektion (Betonung); Tint ~240,240,252
MotionLC-13, LC-29~32Eine dominante Dauer (100/300/320/400ms, 3370%); 23 Stufen, zweite 1.3~1.6×; nur opacity(+transform), kein clip-path·filter 0; reduced-motion Pflicht
SelbstbewertungLI-1~23 · #86landing-integrity.mjs mechanische Beurteilung (Page vh·Sektionsverhältnis·Fold-Coverage·Typverhältnis·Gutter·Dauer·easing·snap·Video-Attribute·Stock-Hosts·einheitliches Kartenraster·h1) · text-contrast.mjs Textkontrast auf Foto·Fokus-Ring·no-JS

Harte Regeln

  • Keine Token·Markenfakten erfinden, die nicht in DESIGN.md stehen. Keine "Geschmacks"-Regeln erfinden, die nicht im Codex stehen — nicht begründete Urteile in concept.md als "Annahme" kennzeichnen.
  • Bei Konflikt zwischen Codex-Wert und DESIGN.md-Token gewinnt DESIGN.md (z.B. Codex LC-21 display:body 3.0×↑ vs tos h1 36/body 14 = 2.57×). Zuerst prüfen, ob die Anwendungsobjekte identisch sind; Unterschreitung und Begründung im Anwendungsbereichs-Tabelle dokumentieren. Dies ist kein automatischer PASS. Bei DESIGN.md ohne Motion-Token (häufig) Codex-Werte LC-29/30 (300/400ms etc.) als "Lokale Erweiterung" kennzeichnen und verwenden.
  • Keine Verwendung von Original-Site-Copy·Captures·Logo-Quellen. Keine statistischen Werte erfinden.
  • Nur eine Seite erstellen. Anforderung für mehrere Seiten an omd:autopilot (Multi-Page) weiterleiten.
  • Diese Fähigkeit ist ein Generator. Die Beurteilung übernehmen die Tools und omd-designer-review — nie selbst "gut" schreiben.

Verwandte Skills