Communitygithub.com

Produkt-Landingpage (xenxorowdy/product-landing-site)

Erstelle eine markante, barrierefreie, einseitige Marketing-Seite für ein Softwareprodukt mit Next.js App Router, Server-Komponenten, CSS-Modulen und einem durchdachten Designsystem.

Was ist product-landing-site)?

Das Skill „product-landing-site“ ist ein bewährtes Rezept für den Bau einer professionellen, statischen Marketing-Seite, die aussieht wie designed, nicht wie von der Stange, und die einer genauen Prüfung standhält: kontrastgeprüft, tastaturfreundlich, ehrlich über das Produkt und schnell. Es basiert auf der Kesami-Marketing-Seite und generiert eine einzelne Next.js-Seite aus serverseitig gerenderten Abschnitten. Interaktivität ist auf wenige kleine Client-„Inseln“ beschränkt, die DOM-Attribute oder CSS-Variablen umschalten, anstatt neu zu rendern. Es gibt keine UI-Bibliothek, kein Tailwind und keine Animationsbibliothek. Das Skill enthält ein vollständiges, baubares Gerüst, optionale Abschnitte als Arbeitsbeispiele, Skripte zur Akzentfarben-Berechnung und zum Screenshot sowie detaillierte Referenzen zu Designsystem, Abschnittsmustern, Bewegung & Barrierefreiheit, Textgestaltung und Überprüfung. Es unterstützt den Aufbau und die Erweiterung einer Seite mit einem klaren Workflow: Eingaben sammeln, Gerüst kopieren, Marke anpassen, Fakten einpflegen, eine einheitliche Demo-Szene definieren, Abschnitte nach einem festen Raster aufbauen und abschließend verifizieren. Die Seite kommt ohne JS aus, verwendet CSS-Variablen für Zustände, und respektiert „prefers-reduced-motion“. Es ist ideal für Entwickler, die schnell eine hochwertige Landingpage für ein SaaS, Tool oder eine App benötigen, ohne auf schwere Frameworks zurückzugreifen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add xenxorowdy/product-landing-site

In Ihrer bevorzugten KI fragen

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

Dokumentation

Produkt-Landingpage

Ein Rezept, destilliert aus der Kesami-Marketing-Seite, für eine einzelne statische Seite, die designed und nicht vorlagenhaft aussieht und einer genauen Prüfung standhält: kontrastgeprüft, tastaturfreundlich, ehrlich über das Produkt, schnell.

Das Ergebnis ist eine Next.js-Seite aus serverseitig gerenderten Abschnitten. Interaktivität ist auf wenige kleine Client-„Inseln“ beschränkt, die DOM-Attribute oder CSS-Variablen umschalten, anstatt neu zu rendern. Es gibt keine UI-Bibliothek, kein Tailwind, keine Animationsbibliothek.

Was enthalten ist

PfadVerwendung
assets/scaffold/Ein vollständiges, baubares Gerüst (typgeprüft und mit next build verifiziert). Kopieren, nicht neu tippen. Platzhalter-Inhalte, funktionierendes Designsystem.
assets/optional-sections/Drei zusätzliche Abschnitte aus der Original-Seite (ein Vorher/Nachher-Vergleich, eine Datenbegrenzungs-Dateibaum, eine Skript-Wand) als Arbeitsbeispiele. Nicht eingebunden.
scripts/accent.mjsLeitet die kontrastsicheren Akzent-Abstufungen für jede Markenfarbe ab.
scripts/capture.cjsErstellt Screenshots der laufenden Seite in Desktop- und Handy-Breite, durchläuft dabei das Scrollen, über ein unsichtbares Electron-Fenster.
references/design-system.mdTokens, Themes, Schriftarten, Abstände, die Akzent-Kontrast-Logik und warum jedes existiert. Vor Änderungen an Farben oder Schrift lesen.
references/section-patterns.mdJeder Abschnitt: wofür er ist, wie er gebaut ist, der Trick, der ihn billig macht. Vor dem Hinzufügen oder Umformen eines Abschnitts lesen.
references/motion-and-a11y.mdBewegungsbudget, reduzierte Bewegung, kein JS, Berührungsziele, Hydrierungsfallen. Vor dem Hinzufügen von Animationen oder Client-Code lesen.
references/copy-and-facts.mdStimme, die Ein-Szenario-Regel und wie Behauptungen wahr bleiben. Vor dem Schreiben von Text lesen.
references/verify.mdDie Checkliste und die auszuführenden Befehle, bevor die Seite als fertig bezeichnet wird.

Arbeitsablauf

1. Eingaben sammeln (erst schauen, dann fragen)

Lies zuerst die README des Produkts, das Paketmanifest, die Preis-/Plan-Codes und den Release-Workflow; die meisten Antworten sind dort. Frage den Benutzer nur nach dem, was nicht zu finden ist. Du brauchst:

  • Produktname, Ein-Satz-Versprechen, für wen es ist, und das eine, was es auszeichnet.
  • Plattformen, Preise und Planlimits, jeweils mit der Datei, die die Quelle der Wahrheit ist.
  • Eine Markenfarbe (irgendein Hex-Wert) oder die Erlaubnis, eine auszuwählen. Wähle eine einzige Farbe und verwende sie als einzige Signalfarbe.
  • Ob eine lizenzierte Auszeichnungsschriftart existiert. Falls nicht, ist der Open-Lizenz-Ersatz des Gerüsts (Instrument Serif) in Ordnung.
  • Welche Abschnitte zutreffen. Standardset: Hero, Ticker, Wie es funktioniert, Frage/Demo, Preise, FAQ, Abschluss, Footer. Füge Datenschutz, Sprachen oder einen Vorher/Nachher-Vergleich hinzu, wenn das Produkt eine Geschichte hat, die eine solche erfordert.
  • Wo die Seite lebt. Standard: einem website/ Ordner im Produkt-Repository, ein eigenständiges Paket außerhalb von npm-Workspaces, damit die Installationen und die Lockfile der App unberührt bleiben.

2. Gerüst erstellen

cp -R ~/.claude/skills/product-landing-site/assets/scaffold <target>/website
cd <target>/website && npm install && npx tsc --noEmit && npx next build

Führe den Build einmal vor dem Bearbeiten aus, damit du weißt, dass der Ausgangszustand grün ist. Mona Sans wird zur Build-Zeit von Google Fonts abgerufen und dann von der Seite selbst ausgeliefert, daher benötigt der erste Build Netzwerkzugriff.

3. Marke anpassen

  1. node ~/.claude/skills/product-landing-site/scripts/accent.mjs <marken-hex> gibt --accent, --accent-display, die abgeflachte Tönung und aus, ob die Beschriftung des Buttons schwarz oder weiß sein soll. Füge diese in app/globals.css ein (--brand, --brand-hover, --brand-tint, --accent, --accent-display) und ersetze die hartcodierten #ff5e00 / #e25300 in app/icon.svg und app/opengraph-image.tsx.
  2. Zeichne das Markenzeichen in components/Logo.tsx und Logo.module.css neu (der Platzhalter sind vier Sprachbalken). Halte es als Divs oder Inline-SVG, niemals als Rastergrafik.
  3. Setze SITE in lib/site.ts (Name, Slug, Wortmarke, Überschrift, Einleitung, CTA, Notiz). Der Slug definiert auch den Namensraum für die Währungspräferenz im localStorage.

Warum das Skript statt nach Augenmaß: Eine gesättigte Markenfarbe erreicht fast nie 4,5:1 als Text auf einer hellen Seite, daher benötigt die Seite die Markenfarbe für Füllungen und einen dunkleren Geschwisterton für Text. Das Erraten des Geschwistertons führt zu Seiten mit fehlendem Kontrast.

4. Fakten vor dem Text

Fülle lib/site.ts (Pläne, Plattform, Links, FAQ) aus den eigenen Quelldateien des Produkts und halte die Quelle jeder Tatsache in der README.md der Seite unter „Woher die Fakten kommen“ fest. Bewahre die Herkunft in der README und nicht in Code-Kommentaren auf, damit das Gerüst kommentarfrei bleibt. Falls das Ziel-Repository oder der Benutzer erklärende Kommentare wünscht, folge stattdessen deren Vorgaben.

Lies dann references/copy-and-facts.md und schreibe den Text.

5. Ein Szenario, überall geteilt

lib/demo.ts enthält ein einziges fiktives Szenario, aus dem der Hero-Mock, die Produktgeschichte und die interaktive Demo alle schöpfen. Ersetze es durch ein Szenario aus der eigenen Domäne des Produkts (Support-Tickets, ein Pull-Request, ein Kalender, eine Tabelle, ein Meeting). Da jeder Abschnitt dieselben Daten liest, widerspricht sich die Seite nie, und die Demo kann ehrlich den tatsächlichen Vertrag des Produkts zeigen (z. B. zitiert jede Behauptung ihre Quelle).

6. Abschnitte

Beginne mit den neun Abschnitten des Gerüsts. Entscheide für jeden Abschnitt: Welche einzelne Idee vermittelt er, und was ist die eine visuelle Darstellung, die sie beweist, anstatt sie zu beschreiben? Lese references/section-patterns.md. Halte dich an die Abschnitts-Grammatik:

  • Label-Chip (.label, mit data-scramble), dann ein h2.display.h2 mit den letzten Wörtern in .em, dann eine optionale .lead
  • Abschnitte wechseln zwischen data-theme="light" / "paper", so dass jeder auf einer Farbkante beginnt, nicht auf einer Linie
  • Ein ausgefüllter Button pro Viewport; alles andere ist ein Textlink mit der Marken-Unterstreichung
  • Produkt-Mocks verwenden data-theme="dark" und Pixel-Größen, da sie als Platzhalter für Screenshots der (dunklen) App dienen. Wenn die App hell ist, mache die Mocks hell.

7. Verifizieren

Folge references/verify.md. Kurz gesagt: Typ-Prüfung, Build, Screenshots bei 1440 und 390 mit scripts/capture.cjs, sie ansehen, durch das Scrollen gehen, um zu bestätigen, dass Enthüllungen feuern, reduzierter Bewegungsmodus und kein JS prüfen, accent.mjs --check für jede neue Textfarbe erneut ausführen. Melde alles, was nicht verifiziert wurde, anstatt zu implizieren, dass es verifiziert wurde.

Unverhandelbar, und warum

  • Server-Komponenten standardmäßig; Client-Inseln nur für Verhalten. Die Seite ist statisches HTML, das ohne JS funktioniert und fast nichts kostet zu hydrieren. Inseln schreiben data-*-Attribute oder CSS-Variablen und lassen CSS die visuelle Arbeit erledigen.
  • Nur semantische Tokens in Komponenten. Komponenten lesen --bg, --fg, --accent; ein data-theme eines Abschnitts tauscht sie aus. So kann eine Komponente auf Hintergrund, Weiß, der Tönung oder einem dunklen Mock ohne Bearbeitungen sitzen.
  • Textgrößen in rem, Mocks in px. Die Browserschriftgröße der Leser muss auf die Seite angewendet werden; Mocks sind Platzhalter für Screenshots.
  • Abgedunkelter Text zurückweichen durch Farbe, nie durch Deckkraft. Deckkraft senkt leise den Kontrast unter 4,5:1.
  • Text überholt nie das Produkt. Keine unveröffentlichten Plattformen, keine Support-Adresse, die nicht existiert, kein „nichts verlässt dein Gerät“, wenn Audio zu einem Server streamt. Eine Marketing-Seite, die zu viel verspricht, ist ein Fehler.
  • Keine Animation-Pause-Steuerung ist eingebaut. Sich wiederholende Bewegung stoppt für prefers-reduced-motion. Die Kesami-Design-Review hat bewusst auf eine Pause-Steuerung verzichtet, daher hat das Gerüst keine; biete eine an, wenn der Benutzer sie wünscht.

Über das Gerüst hinaus erweitern

Erfinde neue Abschnitte mit denselben Primitiven, anstatt eine Bibliothek zu importieren: CSS Custom Properties für den Zustand, ein IntersectionObserver pro Verhalten, details/summary für Offenlegung, position: sticky für Scrollytelling, @property für das Animieren von Variablen. Wenn du dabei ertappst, nach framer-motion oder einem Karussell-Paket zu greifen, lies zuerst references/motion-and-a11y.md; die Antwort ist fast immer eine CSS-Variable und ein Attribut.

Verwandte Skills