Communitygithub.com

Im-Fran/landing-skills

Verwenden beim Erstellen einer Landingpage im Code, inklusive HTML-Struktur, CSS, responsivem Layout, Schriftarten, Bildern, Meta-Tags, Social Cards, strukturierten Daten, Lead-Capture-Formularen, Barrierefreiheit oder Ladeleistung in reinem HTML, Astro, Next, Vite mit React oder Tailwind.

Was ist landing-skills?

Dieses Skill-Set (Landing Build) definiert einen strengen, deterministischen Prozess zur Erstellung statischer Landingpages. Es verhindert systematisch zwei häufige Fehler: Die Verwendung von `padding`-Kurzschreibweisen, die den vertikalen Abstand zwischen Sektionen aufheben (behoben durch eine klare Trennung von Sektion und Container), sowie tote Formulare ohne tatsächlichen Server-Endpunkt (behoben durch echte `action`- und `method`-Attribute). Das Skill liest die für die Seite erforderlichen Informationen aus strukturierten Dateien (`brief.md`, `copy.md`, `direction.md`, `tokens.css`), erkennt das verwendete Technologie-Stack (Astro, Next.js, Vite mit React, einfaches HTML oder andere) und erstellt eine voll funktionsfähige, barrierefreie HTML-Seite, die auch ohne JavaScript komplett ist: Besucher können alle Sektionen lesen, über die Navigation erreichen und Formulare absenden. Der Prozess umfasst die Generierung von SEO-Meta-Tags, das Self-Hosting von Schriftarten, den Aufbau eines exakten Seitengerüsts mit Containern und Sektionen, das Einfügen von Bildern und Platzhaltern, den Bau von Formularen mit echten Endpunkten sowie die Sicherstellung einer grundlegenden Barrierefreiheit (z. B. Skip-Links, Kontrast). Am Ende wird eine detaillierte Übergabeliste erstellt, die alle Platzhalter, Assets und Konfigurationen auflistet, sodass die Landingpage nahtlos an nachfolgende Skills für Animationen, Review und Launch übergeben werden kann. Unterstützt werden unter anderem Astro, Next.js, Vite mit React und Tailwind CSS.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Im-Fran/landing-skills/tree/HEAD/skills/landing-build

In Ihrer bevorzugten KI fragen

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

Vorschau

Aus dem Skill-README

landing-skills preview

Dokumentation

Landing Build

Wandle die genehmigten Texte, die visuelle Ausrichtung und die Design-Tokens in eine statische Seite um, die auch ohne JavaScript voll funktionsfähig ist. Voll funktionsfähig bedeutet, dass ein Besucher jeden Abschnitt lesen, jeden Abschnitt über die Kopfzeile erreichen und das Formular absenden kann. Bewegungen und 3D kommen später, von landing-skills:landing-motion, und bauen auf einer bereits funktionierenden Seite auf.

Zwei Fehler traten in mehreren Testbauten auf, die ohne dieses Skill erstellt wurden. Dieses Skill ist so gestaltet, dass beide unmöglich werden:

  1. Eine Container-Klasse mit einer padding-Kurzschreibweise überschrieb den vertikalen Abstand der Sektion, sodass jede Sektion direkt an die nächste anschloss. Der Fix ist strukturell: Die Sektion besitzt die Blockachse, der Container die Inline-Achse, und keiner verwendet die Kurzschreibweise (Schritt 5).
  2. Ein totes Formular: action="#", onsubmit="return false" oder ein Skript, das "Danke" anzeigte und die Daten wegwarf. Der Fix: eine echte action, eine echte method, eine serverseitige Erfolgsseite und keine Erfolgsmeldung, die die Seite nicht bestätigen kann (Schritt 8).

Eingaben

Lies diese vor dem Schreiben von Code aus dem Projekt des Benutzers.

| Datei | Was du daraus nimmst | |---|---|---| | landing/brief.md | Die Felder, die landing-skills:landing-page schreibt. Du verwendest: Sprache (für lang); Conversion-Aktion (entweder ein Formular mit seinen Feldern und seinem Endpunkt oder none yet, oder eine externe URL); Stack (wie benannt, oder detect); Domain (die Produktionsdomain, oder unknown); Kontaktwege (für die Fußzeile und /form-error/); Verfügbare Assets | | landing/copy.md | Eine H2 pro Seitenabschnitt in Seitenreihenfolge; die letzte H2, Placeholders, listet jede Lücke auf | | landing/direction.md | Schriftarten mit Quelle und Lizenz, das Layout-Row für jeden Abschnitt, Bildmaterial mit Seitenverhältnissen, Oberflächen und die letzte H2 Motion and 3D intent | | landing/tokens.css | Die benutzerdefinierten Eigenschaften: --color-*, --font-*, --text-*, --space-*, --radius-* |

Wenn eine Eingabe fehlt:

  • Keine copy.md: Schreibe keine Marketingtexte selbst. Frage den Benutzer nach dem Text oder schlage landing-skills:landing-copy vor. Wenn der Benutzer dir Text gibt, verwende ihn wie geschrieben. Erfinde niemals Beweise: keine Testimonials, Logos, Zählungen oder Bewertungen. Ein fehlendes Stück wird zu [PLATZHALTER: was wird benötigt].
  • Keine direction.md oder tokens.css: Schlage zuerst landing-skills:landing-art-direction vor. Wenn der Benutzer ohne fortfahren möchte, schreibe landing/tokens.css selbst mit den fünf Präfixen, leite die Werte aus den Markenbeschränkungen ab, die der Benutzer angibt, und teile dem Benutzer mit, dass diese Tokens vorläufig sind.
  • Keine brief.md: Frage nach der Sprache, der Conversion-Aktion (ein Formular und wohin es posten soll, oder eine externe URL), der Produktionsdomain und einem Kontaktweg.
  • Ein Brief-Feld, das unknown oder none yet sagt, ist eine Lücke, kein Fehler: Baue mit der Regel, die dieses Skill dafür vorgibt (keine URL-Tags ohne Domain, der /api/lead-Platzhalter ohne Endpunkt, eine Platzhalter-Kontaktzeile ohne Kontaktwege) und liste es in der Übergabe auf. Erkenne das Stack aus den Projektdateien (siehe "Stack-Erkennung"), anstatt zu fragen, wenn du kannst.

Prozess

1. Erkenne das Stack

Verwende die Tabelle in "Stack-Erkennung". Lies den entsprechenden Abschnitt von references/adapters.md, bevor du Dateien schreibst; er behandelt nur, was von den einfachen Rezepten in den anderen Referenzen abweicht.

2. Erstelle ein Inventar

Schreibe vor jeglichem Markup auf:

  • Jede H2 der copy.md und welches <section> sie wird, mit ihrer id.
  • Jeden Token-Namen in tokens.css. Du wirst diese Namen und keine anderen für Farbe, Schriftart, Abstand und Radius verwenden.
  • Jedes Bild, das die Direction verlangt, sein Seitenverhältnis und ob die Datei existiert.
  • Die Conversion-Aktion aus dem Brief: eine externe URL (ein Link, kein Formular) oder ein Formular mit seinen Feldern und seinem Endpunkt. Mit dem Endpunkt none yet postet das Formular an /api/lead und diese Lücke wird in der Übergabe vermerkt (Schritt 11).
  • Die Domain (bekannt oder unknown) und die Kontaktwege, die der Kopf, die Fußzeile und /form-error/ benötigen.

3. Schreibe den Kopf

Titel, Beschreibung, Canonical, Open Graph und Social Card, Favicon-Set, theme-color, lang, strukturierte Daten. Vorlagen und Regeln sind in references/seo-meta.md. Schreibe Titel und Beschreibung aus copy.md; ein Standardtitel wie der Starter-Titel des Frameworks ist ein verräterisches Zeichen.

4. Lade die Schriftarten

Hoste die in der Direction genannten WOFF2-Dateien selbst, deklariere @font-face mit Familiennamen, die exakt mit den Stapeln in tokens.css übereinstimmen, füge einen metrisch passenden Fallback hinzu und lade nur die ein oder zwei Dateien vor, die oberhalb der Falte verwendet werden. references/performance.md enthält das Rezept und ein getestetes Skript, das die Fallback-Werte berechnet. Eine Seite, die eine Schriftart nennt und sie nie lädt oder auf system-ui zurückfällt, rendert auf jedem Rechner anders.

5. Baue das Layout-Skelett

Jeder Streifen der Seite ist ein <section class="section"> mit einem <div class="container"> darin. Die beiden teilen sich nie eine Aufgabe:

/* Die Sektion besitzt den vertikalen Rhythmus, der Container besitzt Breite und Ränder. */
.section { padding-block: var(--space-section-open); }
.container {
  inline-size: min(100% - 2 * var(--space-gutter), var(--space-content-max));
  margin-inline: auto;
}

Die obigen Token-Namen sind Beispiele; verwende die Namen in deiner tokens.css. references/css.md listet jede Token-Rolle auf, die die Rezepte annehmen, und was zu tun ist, wenn deine Datei keinen Token dafür hat. Der Container setzt überhaupt kein Padding, sodass keine Regelreihenfolge oder Spezifität den Abstand der Sektion löschen kann. Verwende niemals die padding- oder margin-Kurzschreibweise für eine Sektions- oder Container-Klasse: Eine Kurzschreibweise setzt beide Achsen und ersetzt stillschweigend diejenige, die die andere Klasse gesetzt hat. Das ist die Regel, die Fehler 1 beseitigt. references/css.md zeigt die fehlerhafte Version neben dieser sowie die Fälle für Full-Bleed und Hairline.

6. Baue die Sektionen

  • Verwende semantische Elemente: header, nav, main, section, footer, ol für Schritte, dl oder table für Spezifikationen, figure für Medien mit einer Bildunterschrift.
  • Eine h1, im Hero. Jede Sektion beginnt mit einer h2 aus copy.md. Überspringe keine Ebenen.
  • Lege jede Sektion so aus, wie ihr Row in direction.md es sagt. Wenn die Direction die Form offen lässt, wähle aus den Rezepten in references/css.md; Anzahl und Form der Blöcke folgen dem Inhalt, also erscheinen drei gleiche Karten nur, wenn der Inhalt drei gleiche Dinge sind.
  • Verwende die Tokens für jede Farbe, Schriftart, Größe, Abstand und Radius. Deklariere niemals einen Token im Seiten-CSS neu. Wenn ein benötigter Wert keinen Token hat, setze ihn aus Tokens zusammen (calc(), color-mix()) und liste ihn in der Übergabe, damit die Direction ihn hinzufügen kann.
  • Verwende fließende Größen mit clamp(), logischen Eigenschaften, oklch()-Farbe mit den Fallbacks in references/css.md und Container-Queries für Komponenten, die ihre Form mit ihrer eigenen Breite ändern.

7. Platziere die Medien

Echte Bilder erhalten width und height, alt-Text, der sagt, was darauf zu sehen ist, moderne Formate mit einem Fallback, und fetchpriority="high" nur auf dem Hero-Bild (references/performance.md). Ein Asset, das noch nicht existiert, wird zu einem sichtbaren, beschrifteten Platzhalterfeld mit dem endgültigen Seitenverhältnis, mit Text wie [PLATZHALTER: Foto, die Werkbank von oben, 3:2]. Gib dem Feld kein role="img": Es würde ein Foto ankündigen, das nicht existiert. Gib jedem Platzhalter das Verhältnis, die Breite und den Grund, den die Direction diesem Bild gibt, damit die Rahmen das geplante Layout zeigen und nicht eine Reihe identischer gestrichelter Kästchen (references/css.md, Medienplatzhalter). Zeichne niemals einen gefälschten Produktbildschirm und präsentiere ihn als das Produkt.

8. Baue die Conversion-Aktion

Die Conversion-Aktion des Briefs entscheidet, was du baust:

  • Eine externe URL (Checkout, Buchungsseite, App Store): Die Aktion ist ein Link, <a class="button" href="https://..."> mit dem Label aus copy.md. Es gibt kein Formular, keine form.js und keine /thanks/- oder /form-error/-Seite; überspringe den Rest dieses Schritts. Wenn der Brief sagt, dass der Klick gezählt werden soll, fügt landing-skills:landing-launch den Beacon hinzu.
  • Ein Formular mit einem Endpunkt, den der Benutzer bereits hat: Das Formular postet an diese URL und der /api/lead-Platzhalter wird nicht verwendet. Baue die Ergebnis-Seiten nur, wenn dieser Endpunkt dorthin weiterleitet; sage andernfalls in der Übergabe, wohin der Endpunkt den Besucher sendet.
  • Ein Formular mit dem Endpunkt none yet: Das Formular postet an den Platzhalter /api/lead, den landing-skills:landing-launch als Worker baut.

Für ein Formular lies references/forms-a11y.md. Die nicht verhandelbaren Teile:

  • <form action="..." method="post"> mit dem Endpunkt aus dem Brief oder action="/api/lead" mit einem HTML-Kommentar daneben, der besagt, dass der Endpunkt noch nicht existiert, aufgeführt in der Übergabe.
  • Jedes Feld hat einen name, ein sichtbares <label>, den richtigen type und autocomplete und einen Hinweis, der mit aria-describedby verknüpft ist, wenn das Format erklärt werden muss.
  • Ohne JavaScript sendet der Browser das Formular und der Endpunkt antwortet mit einer 303-Weiterleitung auf eine von zwei statischen Seiten, die du jetzt baust: /thanks/ und /form-error/. Sobald landing-skills:landing-launch Turnstile hinzufügt, hat ein Besucher ohne JavaScript kein Token und landet immer auf /form-error/, daher muss diese Seite eine andere Kontaktmöglichkeit bieten, die aus den Kontaktwegen des Briefs stammt.
  • Liefere immer form.js aus references/forms-a11y.md als progressive Verbesserung aus. Das Formular funktioniert auch ohne; die Datei ist dennoch Teil des Builds, weil landing-skills:landing-motion die Zustände erweitert, die sie setzt, und landing-skills:landing-launch sie überprüft. Es zeigt Erfolg nur an, wenn die Antwort ein 2xx-Status ist und ihr JSON-Body ok: true sagt. Ein 2xx-Status allein beweist nur, dass etwas geantwortet hat: fetch folgt einer Weiterleitung und meldet die Seite, auf der es landet, als 200, und ein statischer Host kann auf einen POST mit einer gewöhnlichen HTML-Seite antworten. Beides ist beim Testen passiert, und beides sind Fehler. Bei einem Fehler sagt das Skript dies und behält, was der Besucher eingegeben hat. Setze das Formular niemals zurück oder zeige "Danke", bevor der Server bestätigt hat.

9. Erreiche das Mindestmaß an Barrierefreiheit

Skip-Link, Landmarken, ein nav, dessen Links auf echte Sektions-IDs verweisen, das Logo, das auf / verlinkt, ein sichtbarer Fokus-Stil auf jedem interaktiven Element, Ziele von mindestens 44 mal 44 px und eine Kontrastprüfung jedes Text- und Hintergrundpaars, das die Seite tatsächlich rendert: Fließtext auf jeder Oberfläche, Bildunterschriften, Hinweise, Platzhaltertext, Text auf der Akzentfarbe. Details und Zahlen sind in references/forms-a11y.md. Eine Navigation, die ihre Links auf dem Handy ohne Ersatz verbirgt, besteht dieses Mindestmaß nicht; lass die Links stattdessen umbrechen.

10. Lass Bewegungen weg

Bei reduzierter Bewegung wird die Bewegung reduziert, niemals das Feedback. Schreibe daher keine globale Regel, die Übergänge auf null setzt. Baue jedes Element in seinem endgültigen, sichtbaren Zustand. Keine Eingangsanimationen, kein opacity: 0, das auf ein Skript wartet, keine Scroll-Bibliotheken.

Für jeden Moment, der in der Motion and 3D intent der Direction genannt wird, hinterlasse einen Platzhalter: ein Standbild oder einen beschrifteten Platzhalter in der endgültigen Größe und dem endgültigen Seitenverhältnis des Moments, damit sich das Layout nicht verschiebt, wenn landing-skills:landing-motion das Echte montiert. Markiere es mit data-moment="<name>" und verwende den Kurznamen, den die Direction diesem Moment gibt; die Bewegung findet ihr Ziel über dieses Attribut. Der Platzhalter ist ohne Bewegung vollständig: ein echtes Bild mit alt-Text oder Platzhaltertext, der sagt, was der Moment zeigt.

<div class="hero__media" data-moment="exploded-view">
  <img src="/img/exploded-poster.jpg" width="1600" height="1000" alt="Die Schichten des Geräts auseinandergezogen: Gehäuse, Platine, Akku, Linse">
</div>

Wenn die Absicht none ist, füge keine data-moment-Elemente hinzu.

11. Überprüfe und übergib

Führe die "Definition of done" aus. Teile dem Benutzer dann in einer kurzen Liste mit:

  • was gebaut wurde und wo (Dateien, Ausgabeordner) und das aufgelöste Stack, das in das Stack-Feld des Briefs geschrieben wurde, wenn es detect sagte,
  • jeden [PLATZHALTER: ...], der noch auf der Seite ist, und jedes Asset, das bereitgestellt werden muss,
  • die gebaute Conversion-Aktion: ein Link zu einer externen URL, ein Formular, das an den Endpunkt des Benutzers postet, oder ein Formular, das an /api/lead postet, das noch nicht existiert,
  • jedes Feld, das das Formular sendet, eine Zeile pro Feld: sein name, sein Typ (email, tel, text, textarea), ob es required ist, und sein maxlength aus dem Markup. landing-skills:landing-launch richtet die Validierung seines Workers, die Längenbegrenzungen, die Speicherung und das Größenlimit für Anfragen anhand dieser Liste ein und weist ein Feld zurück, von dem es nicht wusste,
  • Werte, die zusammengesetzt wurden, weil kein Token existierte, und jeden optionalen Token, den tokens.css nicht hatte, mit dem Fallback, den die Rezepte dafür verwendet haben,
  • die Produktionsdomain, wenn der Brief unknown sagt, und die URL-Tags, die deswegen weggelassen wurden (Canonical, og:url, og:image, Sitemap),
  • Kontaktwege, die der Brief als unknown hinterlassen hat und die die Fußzeile und /form-error/ als Platzhalter anzeigen,
  • jede Schriftartdatei, die nicht subsetiert wurde, mit ihrer Größe in Bytes,
  • jede Überprüfung der Definition of done, die nicht ausgeführt wurde, markiert als "nicht ausgeführt" mit dem Grund,
  • jeden Moment aus Motion and 3D intent: seinen data-moment-Namen und wo sein Platzhalter sitzt (Sektion und Element), oder "none", wenn die Absicht none ist,
  • das nächste Skill: landing-skills:landing-motion, wenn die Motion and 3D intent der Direction einen Moment nennt, dann landing-skills:landing-review, dann landing-skills:landing-launch für Hosting und den Formular-Endpunkt.

Stack-Erkennung

Überprüfe das Projekt-Root in dieser Reihenfolge und stoppe bei der ersten Übereinstimmung. Das Feld Stack in brief.md entscheidet, wenn der Projektordner leer ist.

Sobald das Stack aufgelöst ist, schreibe es zurück: Wenn das Stack-Feld des Briefs detect sagt, ersetze dieses eine Wort durch das aufgelöste Stack (z. B. Astro oder einfaches HTML und CSS) und ändere nichts anderes in landing/brief.md. Spätere Skills lesen das Feld und sollten kein unaufgelöstes Wort antreffen. Ein Stack, das der Benutzer genannt hat, bleibt wie geschrieben stehen. Wenn es keine landing/brief.md gibt, erstelle keine.

Signal im ProjektStackAdapter-Abschnitt
astro.config.mjs (oder .ts, .js) oder astro in package.json-AbhängigkeitenAstroAstro
next.config.js (oder .mjs) oder next in package.json-AbhängigkeitenNext.jsNext.js
vite.config.js (oder .ts) und react in package.json-Abhängigkeiten und KEIN nextVite + ReactVite + React
package.json mit tailwindcss in devDependencies und eine tailwind.config.*-DateiTailwind CSS (als Zusatz)Wie das Basis-Stack, befolge die Referenzen mit Tailwind-Integration
Keine der obigen, aber Projektdateien vorhandenEinfaches HTML und CSS (kein Framework)(Keine; die Hauptreferenzen gelten direkt)
Keine Projektdateien gefunden oder Ordner leerdetect (kann nicht auflösen)Frage den Benutzer nach dem Stack oder schlage plain HTML and CSS vor

Definition of done

Führe jede Prüfung aus, die durchführbar ist. Prüfungen, die eine Live-Umgebung oder Assets erfordern, die es noch nicht gibt, werden in der Übergabe als "nicht ausgeführt" markiert.

  • Wird das Dokument ohne JavaScript gerendert? Die Seite zeigt alle Abschnitte, die Navigation funktioniert, das Formular sendet.
  • Gibt es genau eine h1?
  • Enthält jede Sektion eine h2 aus copy.md?
  • Sind alle Sektions-IDs eindeutig?
  • Entspricht die Seitenreihenfolge der Reihenfolge in copy.md?
  • Haben alle <a>-Tags ein href-Attribut?
  • Haben alle <img>-Tags width, height und alt (nicht leer)?
  • Verwenden alle Farben, Schriftarten, Abstände und Radien Token aus tokens.css?
  • Hat die Seite ein Favicon?
  • Sind lang, charset und viewport gesetzt?
  • Gibt es ein sichtbares Skip-Link in der Kopfzeile?
  • Erreicht jedes interaktive Element mindestens 44x44 px?
  • Besteht jedes Text-Hintergrund-Paar den Kontrast-Check (WCAG AA)?
  • Ist die oklch()-Farbe mit einem Fallback abgesichert?
  • Hat die Sektion padding-block und der Container weder padding- noch margin-Kurzschreibweise?
  • Wird fetchpriority="high" nur auf dem Hero-Bild gesetzt?
  • Haben Formularfelder alle name, label, type und autocomplete?
  • Wird das Formular bei nicht unterstütztem JavaScript per POST gesendet und die Antwort per 303 weitergeleitet?
  • Hat /form-error/ eine alternative Kontaktmöglichkeit?
  • Wird keine opacity: 0- oder Übergangsregel auf den Standard-CSS-Pfad angewendet?
  • Ist jedes data-moment-Element ein vollständiger, bewegungsloser Platzhalter?

Individual skills in this repo

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

Verwandte Skills