Communitygithub.com

Im-Fran/landing-skills

Dient der Auswahl der visuellen Ausrichtung einer Landingpage – inklusive Schriftarten, Farbpalette, Layout, Bildsprache oder Design-Tokens – und wird verwendet, wenn eine Seite vorlagehaft, generisch oder KI-generiert wirkt.

Was ist landing-skills?

Diese Fertigkeit legt das visuelle Erscheinungsbild einer Landingpage fest, bevor der Markup-Code geschrieben wird. Das Ergebnis sind zwei Dateien: `landing/direction.md`, eine schriftliche Ausrichtung mit Begründung für jede Entscheidung, und `landing/tokens.css`, die Design-Tokens, die `landing-skills:landing-build` unverändert und `landing-skills:landing-motion` für die Absicht nutzt. Sie ist für KI-Agenten in Tools wie Claude Code, Cursor oder Codex konzipiert und stellt sicher, dass jede Entscheidung spezifisch für den jeweiligen Kunden getroffen wird. Der Prozess durchläuft 10 Schritte, von der Bestandsaufnahme über Typografie und Farbe bis hin zu Layout, Bildmaterial, Bewegungsabsicht und einem abschließenden Selbstcheck. Dabei werden Standardlösungen und häufige Fallstricke vermieden, indem jede Wahl auf konkrete Anker aus der Kundenwelt zurückgeführt wird.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Gestaltungsausrichtung für Landingpages

Sie entscheiden, wie die Seite aussieht, bevor jemand Markup schreibt. Die Ausgabe besteht aus zwei Dateien: landing/direction.md, einer schriftlichen Ausrichtung mit Begründung für jede Entscheidung, und landing/tokens.css, den Design-Tokens, die landing-skills:landing-build unverändert und landing-skills:landing-motion für die Absicht nutzt.

Die Aufgabe besteht darin, das Aussehen zu finden, das zu diesem Kunden und zu keinem anderen gehört. Eine Ausrichtung, die zu einem anderen Kunden in einem anderen Gewerbe passen würde, ist eine Vorlage, so geschmackvoll sie auch aussehen mag.

Warum diese Fertigkeit existiert

Agenten ohne Anleitung gaben verschiedenen Kunden das gleiche Aussehen: Creme, ein dunkles Grün oder Terrakotta als Akzent, Systemschriftarten oder Georgia. Eine Wahl wird zum Merkmal, wenn sie die unbedachte Standardeinstellung ist, und ist in Ordnung, wenn sie aus einem für den Kunden eindeutigen Grund getroffen wird. Der Beleg findet sich in references/visual-tells.md.

Eingaben

  1. landing/brief.md: das Produkt, die Zielgruppe, die Conversion-Aktion, die Assets, die Markenvorgaben, die Sprache, der Stack und die Gewünschten Momente (die Bewegungs-, 3D- oder Scrolleffekte, die der Benutzer angefordert hat). Die Ausrichtung gibt jedem gewünschten Moment seine Rolle, seinen Zweck und seine Form mit reduzierter Bewegung im Abschnitt Bewegungs- und 3D-Absicht (Schritt 8).
  2. landing/copy.md: der genehmigte Text, eine H2 pro Abschnitt in Seitenreihenfolge, endend mit Platzhaltern. Die Abschnittsliste ist das Skelett Ihres Layouts und die Wörter geben den Ton an.

Wenn eine der beiden Dateien fehlt oder der Kunde Markenrichtlinien oder ein vorhandenes Stylesheet hat, lesen Sie zuerst references/inputs.md. Kurz gesagt: Der Text kommt zuerst, also führen Sie landing-skills:landing-copy aus, wenn Sie können; arbeiten Sie andernfalls vom Brief aus und kennzeichnen Sie, was vom Text abhängt, als vorläufig.

Prozess

Führen Sie die Schritte der Reihe nach aus. Die Schritte 1 bis 3 erzeugen Text, keine Werte.

Die Lesereihenfolge ist eine Regel. Schreiben Sie die Abschnitte Betreff und Ausrichtung, bevor Sie eine Datei in references/ öffnen, mit zwei Ausnahmen: references/inputs.md, die Sie zu Beginn lesen, wenn eine Eingabe fehlt, und references/visual-tells.md, die Sie in Schritt 2 für den Standardtest lesen. Öffnen Sie dann jede Referenz nur in dem Schritt, der sie verwendet. Der Grund: Eine Tabelle, die gelesen wird, bevor die Ausrichtung existiert, wird zur Antwort, und Leser, die die Tabellen zuerst lesen, wählen die gleichen Schriftarten und Paletten für verschiedene Kunden.

Kurzer Pfad. Für eine Seite mit ein bis drei Abschnitten ohne zu treffende Bildentscheidungen gelten diese Schritte trotzdem in vollem Umfang: Betreff (1), Ausrichtung mit abgelehnten Standardeinstellungen (2 und 3), durch Suche gefundene Schriftarten (4), Palette mit Kontrast (5) und die Kern-Tokens (9). Diese schrumpfen auf eine Zeile pro Abschnitt in direction.md: die Layoutkarte (6), Assets (7) und Bewegungsabsicht (8). Die Konvergenzprüfungen werden nie übersprungen.

1. Bestandsaufnahme des Betreffs

Listen Sie aus dem Brief und dem Text in einfachen Substantiven unter drei Arten von Quellen auf:

  • Material und Objekt: woraus das Produkt besteht oder was es verarbeitet, die Werkzeuge, die Texturen. Bei Software die Dinge, mit denen und an denen seine Benutzer arbeiten.
  • Ort und Licht: wo es hergestellt oder verwendet wird, das Licht dort, die Tageszeit, das Wetter, die Geräusche des Raums.
  • Geste und Moment: was jemand damit tut, ein Geräusch, das es macht, der Moment der Nutzung, der am wichtigsten ist (die erste Nutzung, die erledigte Arbeit, die Pause vor der Entscheidung).

Fügen Sie dann die Umgebung des Publikums hinzu, wenn es die Seite trifft, drei bis sechs Wörter aus dem Text, die beschreiben, wie es klingt, und eine Zeile darüber, was der Besucher glauben muss, bevor er die Aktion ausführt.

Wählen Sie drei Anker, einen aus jeder Art von Quelle: konkrete Dinge mit einer Farbe, einer Textur, einem Rhythmus oder einem Charakter, den Sie benennen können. Zum Beispiel für andere Kunden als Ihren: „das Messing eines Schiffskompasses“ (Material), „tief stehende Wintersonne über einem zugefrorenen Kanal“ (Ort und Licht), „das Klackern eines Weberschiffchens, das einen Webstuhl kreuzt“ (Geste). Die Palette, die Schrift und die Bilder leiten sich von diesen ab.

Die branchenübliche Papierarbeit (Formulare, Quittungen, Etiketten, Zeichnungen, Spezifikationsblätter, Bildschirme) zählt als eine Art von Quelle und kann höchstens einen Anker liefern: Es ist das am einfachsten zu benennende Element, daher zieht es jeden Kunden zum gleichen Look. Der Produkt- oder Firmenname kann einen Anker liefern, wenn er sich auf etwas Reales bezieht (einen Fluss, einen Vogel, eine Straße), niemals die gesamte Palette.

2. Schreiben Sie die Ausrichtung und ihre Begründung

Schreiben Sie einen oder zwei Sätze, die den Look benennen und ihn mit den Ankern verbinden, dann die Begründung: warum dieser Look diesem Publikum und dieser Aktion dient.

Schreiben Sie zwei Ausrichtungen, die Sie in Betracht gezogen und verworfen haben, jede mit ihrer Begründung. Mindestens eine davon ist der offensichtliche Standard für die Kategorie (dunkel und Neon für ein Entwicklertool, Creme und Serife für ein Kunsthandwerksprodukt, kaltes Blau für Gesundheit). „Das branchenübliche Dokument“ (die Seite, die als Hauptbuch, Blaupause, Spezifikationsblatt, Quittung, Etikett oder Formular des Kunden gestaltet ist) ist ein Standard auf derselben Ebene: Wenn es Ihre erste Idee war, lehnen Sie es mit einer Begründung ab, es sei denn, Sie können sagen, was es für diesen Kunden richtig macht und für einen Wettbewerber mit derselben Papierarbeit falsch.

Führen Sie dann zwei Tests durch:

  • Vertauschungstest. Ersetzen Sie den Kunden durch ein Unternehmen in einem anderen Gewerbe. Wenn die Ausrichtung immer noch passt, ist sie generisch; schreiben Sie sie um, bis sie etwas benennt, das nur dieser Kunde hat.
  • Standardtest. Lesen Sie references/visual-tells.md und vergleichen Sie Ihren Plan mit den dort aufgeführten Standardeinstellungen. Wenn der Plan mit einer übereinstimmt, geben Sie den für diesen Kunden spezifischen Grund schriftlich an oder ändern Sie den Plan.

3. Schreiben Sie die Entscheidung fest

Schreiben Sie jetzt die Abschnitte Betreff und Ausrichtung von landing/direction.md, bevor irgendein Token existiert. Alles danach muss auf diese zurückzuführen sein. Wenn eine spätere Wahl dies nicht tut, ändern Sie die Wahl oder überarbeiten Sie die Ausrichtung gezielt und erwähnen Sie dies in der Datei.

4. Typografie

Arbeiten Sie von den Ankern aus, nicht von einem Tonwort: ein Tonwort passt zu vielen Schriften, und jeder Leser mit demselben Wort wählt dieselbe. Verwenden Sie die Klangwörter des Textes nur als Überprüfung des Ergebnisses.

  1. Schreiben Sie zwei bis vier Anforderungen, die die Schrift erfüllen muss, jede anhand eines Schriftmusters überprüfbar und auf einen Anker zurückzuführen (weiche, abgerundete Formen wie abgenutzte Flusssteine; ein schwerer Slab; Oldstyle-Ziffern im Fließtext). Schreiben Sie sie, bevor Sie references/typography.md öffnen.
  2. Entscheiden Sie, wie viele Schriften: eine Familie, zwei Schriften oder auch eine Mono-Schrift, nach den Kriterien in references/typography.md („Entscheiden Sie, wie viele Schriften“). Display plus Text plus Mono ist nicht die Standardform.
  3. Öffnen Sie references/typography.md und befolgen Sie dessen Schritte 3 und 4: Filtern Sie die Kataloge nach Ihren harten Anforderungen, notieren Sie den Filter und die Anzahl der Übereinstimmungen, sehen Sie sich eine Auswahl des Ergebnisses an, wählen Sie mindestens drei pro Rolle aus, davon mindestens zwei durch Suche gefunden, bestätigen Sie Merkmale aus lesbaren Quellen, wählen Sie, notieren Sie zwei abgelehnte Kandidaten und führen Sie dessen Konvergenzprüfung durch. Der Abschnitt „First-reach faces“ listet die Schriften auf, nach denen Leser zuerst greifen.
  4. Wählen Sie einen metriknahen Fallback für jeden Font-Stack, gemäß der Methode in derselben Datei („Font loading notes“), und notieren Sie den Grund.
  5. Passen Sie den Helden für seine tatsächliche Überschrift an; dieselbe Datei enthält die Zahlen.

5. Farbe

Leiten Sie die Palette von den Ankern in OKLCH ab, gemäß der Methode in references/colour.md, einschließlich der Tinte und des Grundes, die wie jede andere Farbe abgeleitet werden. Notieren Sie jede Farbe mit ihrer Rolle, dem oklch()-Wert, dem sRGB-Hex-Fallback und dem Anker sowie dem WCAG-2.2-Verhältnis jedes Text- und Hintergrundpaares, das Sie verwenden werden. Die OKLCH-Helligkeit ist kein Kontrastverhältnis; berechnen Sie das Verhältnis mit dem Skript in dieser Datei.

Wenn die Palette abgeleitet ist, führen Sie die Farbkonvergenzprüfung in references/colour.md durch. Dieselbe Datei behandelt Statusfarben, Linkfarbe, First-reach-Akzente, vorläufige Werte, wenn kein Asset abgetastet werden kann, und ein dunkles Design, das gezielt entworfen wurde.

6. Layout

Ordnen Sie jede H2 in copy.md einer Layoutentscheidung zu: Breite, Ausrichtung, Dichte, Grund und welches Bildmaterial sie trägt. Wählen Sie die ein oder zwei lauten Abschnitte nach dem Test in references/layout.md („Wo man Mut investiert“); ein invertiertes dunkles Band ist eine Wahl mit einem Kriterium dort, nicht die Standardeinstellung.

7. Bildmaterial und Assets

Notieren Sie für jedes visuelle Element, das die Abschnittskarte benötigt, was es zeigt, sein Seitenverhältnis und ob das Asset existiert. references/assets.md behandelt Fotografie, Illustration, Produktaufnahmen, Symbole, Logos und den Fall ohne Assets. Ein fehlendes Asset erhält einen beschrifteten Platzhalter in seinem endgültigen Verhältnis und eine Zeile in der Anfrageliste. Keine Stockfotos von Personen, keine erfundenen Screenshots, kein gezeichnetes Logo; ein Wortmarke in der Display-Schrift gesetzt ist ein akzeptabler Ersatz, der als Vorschlag notiert wird.

8. Bewegungs- und 3D-Absicht

Entscheiden Sie, ob die Seite überhaupt Bewegung oder 3D benötigt; none ist eine gültige und oft richtige Antwort. Geben Sie für jeden Moment, den Sie nennen, seinen Ort, was er zeigt, seinen Zweck (erklären Sie das Produkt, bestätigen Sie eine Aktion, lenken Sie die Aufmerksamkeit auf eine Sache) und seine Version mit reduzierter Bewegung an. Eine 3D-Szene benötigt auch ein Standbild als Poster.

Halten Sie sich standardmäßig an einen signifikanten Moment. Mehr ist gerechtfertigt, wenn jeder etwas anderes erklärt, das ein Standbild nicht zeigen kann. Wenn die Gewünschten Momente des Briefs mehrere anfordern, gewinnt der Brief: nennen Sie jeden, geben Sie ihm seinen Zweck und seine reduzierte Bewegungsform, und platzieren Sie sie so, dass sich keine zwei auf demselben Bildschirm befinden. landing-skills:landing-motion implementiert genau das, was Sie hier schreiben.

9. Schreiben Sie die Tokens

Schreiben Sie landing/tokens.css wie in „Ausgabeformat“ beschrieben. Jeder Farb- und Schrift-Token erscheint in direction.md mit seiner Begründung; jede Skala (Text, Abstand, Radius) wird einmal erklärt, mit ihrer Basis oder ihrem Verhältnis und wofür ihre Schritte da sind. Definieren Sie nur Tokens, die die Seite verwenden wird.

Radius: zwei Werte sind genug, wenn das Design zwei Arten von Elementen hat; fügen Sie einen dritten nur für eine echte dritte Art hinzu. --radius-control ist immer einer von ihnen. Thema: notieren Sie hell, dunkel oder beides unter Farbe; die Tokens-Datei enthält keine color-scheme-Eigenschaft, und das Build setzt sie entsprechend.

10. Selbstcheck, dann Übergabe

Führen Sie die Prüfungen in „Selbstcheck“ durch. Teilen Sie dem Benutzer dann mit, was Sie in wenigen Zeilen entschieden haben, listen Sie die anzufordernden Assets auf und nennen Sie die nächste Fertigkeit: landing-skills:landing-build.

Ausgabeformat

Lesen Sie jetzt references/example.md, nur für das Format beider Dateien. Seine Werte gehören zu einem erfundenen Kunden und sind keine Kandidaten für Ihren.

landing/direction.md

Verwenden Sie diese H2s in dieser Reihenfolge. Die letzte H2 ist immer Bewegungs- und 3D-Absicht.

  1. Betreff: die Bestandsaufnahme und die drei Anker.
  2. Ausrichtung: der Satz, die Begründung, die abgelehnten Ausrichtungen mit Begründungen und das Ergebnis des Vertauschungstests.
  3. Typografie: die in references/typography.md aufgeführte Aufzeichnung („Die Entscheidung aufzeichnen“).
  4. Farbe: Anker mit OKLCH (bei Schätzung als vorläufig gekennzeichnet), Rollen- tabelle, Kontrasttabelle, Themenentscheidung, etwaiger Konvergenzsatz.
  5. Layout: Raster, Rhythmus, eine Zeile pro Textabschnitt, wo die Betonung hin geht.
  6. Bildmaterial und Assets: jedes visuelle Element mit Seitenverhältnis und Status, dann die Asset-Anforderungsliste.
  7. Oberflächen und Details: Radius, Ränder, Schatten, Symbole, mit Gründen.
  8. Bewegungs- und 3D-Absicht: none mit einer Begründung oder ein Eintrag pro Moment.

landing/tokens.css

Nur benutzerdefinierte Eigenschaften auf :root, mit fünf Präfixen und keinen anderen: --color-*, --font-*, --text-* (Größen, Zeilenabstand, Laufweite), --space-* (Abstände, Rhythmus, Maß) und --radius-*. Keine anderen Selektoren, kein @font-face, keine Komponentenstile.

Schreiben Sie die sRGB-Hex-Werte in :root, dann die oklch()-Werte in einem @supports (color: oklch(0 0 0))-Block. Eine benutzerdefinierte Eigenschaft nimmt den zuletzt deklarierten Wert an, selbst wenn der Browser ihn nicht als Farbe parsen kann, daher sind zwei Deklarationen in einer Regel kein Fallback. references/colour.md enthält die Grundgerüste, einschließlich des dunklen Themas.

Jedes tokens.css enthält diesen Kern mit genau diesen Namen, damit landing-skills:landing-build sich darauf verlassen kann:

TokenFür
--color-bgder Seitenhintergrund
--color-inkFließtext und Überschriften auf dem Seitenhintergrund; Inline-Links, unterstrichen
--color-ink-mutedBildunterschriften und sekundärer Text auf dem Seitenhintergrund
--color-lineLinien und Trennlinien
--color-actiondie Steuerfarbe: die Füllung der primären Aktion
--color-action-hoverder Hover- und Gedrückt-Zustand der Aktion
--color-on-actionText auf der Aktionsfüllung
--font-displayÜberschriften (dieselbe Familie wie --font-text bei Verwendung einer Familie)
--font-textFließtext
--text-baseSchriftgröße für Fließtext
--text-displaydie Größe der Helden-Überschrift, an ihre Länge angepasst
--space-gutterseitlicher Abstand der Seite
--space-section-opender Abstand der Abschnitte, die die Hauptaussage tragen
--space-section-denseder Abstand von schnell lesbaren Abschnitten
--space-content-maxmaximale Inhaltsbreite
--radius-controlEcken von Schaltflächen und Eingabefeldern

Alles andere ist frei, innerhalb der fünf Präfixe. Jeder zusätzliche Hintergrund, der Text trägt, erhält ein gepaartes Token, --color-<grund> mit --color-on-<grund>, und jedes Paar hat ein berechnetes Verhältnis. Verwenden Sie niemals ein Hintergrund-Token als Textfarbe. Ein Akzent, der auf einem dunklen Band verwendet wird, benötigt seine eigene bestandene Stufe für dieses Band oder bleibt davon fern (references/colour.md).

Selbstcheck

Bestätigen Sie vor der Übergabe jede Zeile. Korrigieren Sie, was fehlschlägt.

  • Sie haben references/visual-tells.md erneut gelesen und die Ausrichtung sowie die Tokens gegen jede Gruppe und die Tabelle der Merkmale geprüft, die der Detektor nicht sehen kann. Diese Prüfung ist erforderlich.
  • direction.md hat die acht H2s in der richtigen Reihenfolge und endet mit Bewegungs- und 3D-Absicht.
  • Drei Anker aus drei Arten von Quellen, höchstens einer aus der Papierarbeit; der Vertauschungstest bestanden; zwei abgelehnte Ausrichtungen, eine der Kategoriesstandard.
  • Typografie: die Aufzeichnung in references/typography.md („Die Entscheidung aufzeichnen“) ist vollständig, einschließlich des Suchfilters und der Anzahl, der erinnerten oder gefundenen Markierungen und des Konvergenzsatzes, wo dessen Regel gilt.
  • Keine Schrift aus den Gruppen in references/typography.md („Übermäßig verwendete Schriften“) ohne ihre schriftliche Begründung.
  • Die Größe der Helden-Überschrift passt zu ihrer Länge.
  • Farbe: Jede Farbe hat einen Anker oder eine Rolle, einen oklch()-Wert und einen Hex-Fallback; die Farbkonvergenzprüfung in references/colour.md wurde nach der Ableitung durchgeführt.
  • Jedes von Ihnen verwendete Textpaar

…

[zur Übersetzung abgeschnitten]

Individual skills in this repo

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

Verwandte Skills