Communitygithub.com

Im-Fran/landing-skills

Verwenden Sie diese Fertigkeit, um eine Landing Page zu prüfen, zu auditieren oder zu kritisieren, bevor Sie die Arbeit daran für abgeschlossen erklären, oder wenn gefragt wird, ob eine Seite KI-generiert, auf Vorlage basiert oder unprofessionell wirkt.

Was ist landing-skills?

Diese Fertigkeit ermöglicht eine umfassende, strukturierte Prüfung von Landing Pages. Sie auditiert eine Seite und erstellt einen detaillierten Bericht in `landing/review.md`. Der Prozess umfasst mehrere Durchläufe: einen statischen Scan der Quelltexte, eine visuelle Überprüfung der gerenderten Seite in vier Breiten (360, 768, 1280 und 1440 Pixel) und bei Bedarf Tests von Bewegungen und 3D-Elementen. Die Fertigkeit arbeitet mit einer detaillierten Rubrik, die jeden Aspekt abdeckt: Text, Art Direction, Build-Qualität, Bewegungseffekte und Startbereitschaft. Sie erkennt häufige Fehler, die bei oberflächlichen Prüfungen übersehen werden, wie z. B. defekte Formulare, nicht autorisierte Behauptungen, fehlende Barrierefreiheit (z. B. `prefers-reduced-motion`) oder Layout-Probleme, die nur bei bestimmten Bildschirmbreiten auftreten. Die Fertigkeit unterstützt verschiedene Frameworks (Astro, Next.js, Vite) und kann sowohl Quellcodedateien als auch gerenderte Seiten über HTTP prüfen. Sie stellt sicher, dass nur bestätigte Befunde gemeldet werden und erzeugt eine Checkliste mit klaren Bewertungen (bestanden, fehlgeschlagen oder nicht zutreffend) für jede Zeile der Rubrik.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Landing-Review

Sie auditieren eine Landing Page und schreiben ein Urteil in landing/review.md. Die Seite kann aus der landing-skills-Pipeline oder von überall sonst kommen. Sie lesen den Quellcode, betrachten die gerenderte Seite in vier Breiten, testen Bewegungen und 3D, falls vorhanden, und beurteilen alles anhand einer Rubrik.

Seiten, die fertig aussehen, haben oft Fehler, nach denen niemand gesucht hat: Ein Formular, das jeden Lead verwirft, während es dem Besucher dankt; Spezifikationen und Versprechungen, die der Kunde nie gemacht hat; eine 3D-Seite, die leer wird, wenn WebGL nicht verfügbar ist; Seitenabstände, die durch eine andere Regel auf jeder Breite aufgehoben werden. Prüfer, die vier Breiten erfassen und zwei betrachten, übersehen, was nur bei einer auftritt. Ihre Aufgabe ist es, alles zu betrachten und nur das zu melden, was Sie bestätigt haben.

<skill-dir> unten bezeichnet das Verzeichnis, das diese SKILL.md enthält; die Skripte befinden sich in dessen scripts/-Ordner. Wenn die Fertigkeit aus einem Plugin geladen wurde, wurde Ihnen der Pfad dieser Datei beim Laden mitgeteilt; falls nicht, finden Sie ihn mit find ~ -path '*landing-review/scripts/detect-tells.mjs' 2>/dev/null. Führen Sie jeden Befehl aus dem zu prüfenden Projekt aus, wobei die Skripte mit ihrem vollständigen Pfad angegeben werden.

Eingaben

Sie benötigen die Seite und verwenden jeglichen vorhandenen Kontext.

  1. Die Seite. Ein Projektverzeichnis, eine einzelne HTML-Datei oder eine bereitgestellte URL. Finden Sie den Einstiegspunkt: index.html, src/pages/index.astro, src/App.jsx, app/page.tsx oder was auch immer der Stack verwendet. Notieren Sie den Stack; er bestimmt, wie Sie die Seite für den visuellen Durchlauf bereitstellen.
  2. landing/brief.md: Produkt, Zielgruppe, Conversion-Aktion, die Fakten und Nachweise, die der Kunde geliefert hat, die bereitgestellten Assets, die Sprache. Dies ist Ihre Wahrheitsquelle dafür, was die Seite behaupten darf.
  3. landing/copy.md: Der genehmigte Text. Vergleichen Sie die Seite damit.
  4. landing/direction.md und landing/tokens.css: Die visuelle Ausrichtung mit ihren Gründen und die Tokens. Eine Wahl, die wie ein Standard aussieht, ist akzeptabel, wenn die Ausrichtung einen für den Kunden spezifischen Grund angibt.

Wenn Dateien fehlen:

  • Kein Brief. Fragen Sie den Benutzer vier Dinge, bevor Sie Behauptungen beurteilen: Was das Produkt ist, für wen es ist, was die eine Conversion-Aktion ist und welche Fakten, Zahlen, Testimonials und Logos echt sind. Wenn Sie nicht fragen können, nehmen Sie die Fakten aus dem, was die Seite selbst über das Unternehmen sagt, und behandeln Sie jedes Testimonial, jeden Kundennamen, jedes Logo, jede Bewertung und jede Metrik als nicht verifiziert: Melden Sie jedes als Blocker mit dem Fix „Bestätigen Sie, dass dies echt und vom Kunden geliefert wurde, oder entfernen Sie es“. Nicht verifizierte Nachweise, die ausgeliefert werden, sind dasselbe Risiko wie erfundene Nachweise.
  • Kein copy.md oder direction.md. Prüfen Sie den Text und die Optik anhand der Rubrik nach eigenem Ermessen. Sie verlieren die Fähigkeit zu sagen „dies weicht vom genehmigten Text ab“, sonst nichts. Fragen Sie nicht nach diesen Dateien.
  • Kein landing/-Ordner. Erstellen Sie landing/ und landing/shots/ im Projekt; der Bericht und die Screenshots werden dort abgelegt.
  • Die Seite lässt sich nicht bauen oder bereitstellen. Melden Sie dies unter Rubrikzeile B15 mit dem Fehler. Wenn keine gerenderte Seite auf andere Weise (eine bereitgestellte URL, ein früherer Build) bezogen werden kann, kann der visuelle Durchlauf nicht ausgeführt werden, und das Urteil lautet unvollständig (siehe Urteil).

Lesen Sie references/rubric.md, bevor Sie mit den Durchläufen beginnen. Sie enthält jede Prüfung mit der Beschreibung, wie ein Bestehen aussieht, und dem Schweregrad bei Fehlschlag. Lesen Sie references/report-format.md, bevor Sie landing/review.md schreiben. references/snippets.md enthält die Skripte, die die Durchläufe ausführen.

Ablauf

Führen Sie die Durchläufe in dieser Reihenfolge aus und schreiben Sie dann den Bericht:

  1. Statischer Durchlauf: Scannen Sie den Quellcode, lesen Sie ihn dann.
  2. Visueller Durchlauf: Rendern Sie die Seite und betrachten Sie sie in vier Breiten.
  3. Bewegungs- und 3D-Durchlauf: Nur wenn die Seite Bewegung oder eine 3D-Szene enthält.
  4. Gehen Sie die gesamte Rubrik in references/rubric.md durch, Bereich für Bereich: Text, Art Direction, Build, Bewegung, Startbereitschaft. Schreiben Sie eine Arbeits-Checkliste in landing/review-checklist.md mit einer Zeile für jede Zeilen-ID: fail mit dem Ort, pass mit Beleg oder n/a mit dem Grund. Ein Bestehen zählt nur, wenn sein Beleg die Ausgabe der eigenen „Prüfanleitung“ dieser Zeile ist: die Liste, wo eine Liste steht, die Anzahl, wo eine Anzahl steht, und jeder Abschnitt, Header und Footer eingeschlossen, wo alle Abschnitte abgedeckt sind. Eine Zeile, die aus dem Gedächtnis an die Seite angekreuzt wurde, ist nicht abgearbeitet. Lesen Sie Text und Art Direction bei einer kurzen statischen Seite genauso sorgfältig wie bei einer komplexen, und gehen Sie jede Zeile durch, selbst wenn ein Blocker bereits offensichtlich ist: Die Prüfung listet alles auf, was die nächste Runde beheben muss, nicht nur das, was das Urteil bestimmt.
  5. Schreiben Sie landing/review.md, wie in references/report-format.md beschrieben: Fehler in der Tabelle, Bestehen mit ihrem Beleg unter „Geprüft und in Ordnung“. Führen Sie dann die Selbstprüfung am Ende dieser Datei durch.

Machen Sie sich während der Arbeit Notizen: Für jeden Befund, wo Sie ihn gesehen haben (Datei und Zeile oder Breite und Abschnitt) und wie Sie ihn bestätigt haben.

Statischer Durchlauf

Richten Sie den Scanner auf die Quellpfade der Seite, nicht auf ein ganzes Repository:

node <skill-dir>/scripts/detect-tells.mjs index.html styles.css
node <skill-dir>/scripts/detect-tells.mjs src --json

Was er liest: Jede Datei, die Sie direkt benennen, unabhängig von ihrer Erweiterung. In einem Verzeichnis liest er .html, .htm, .css, .scss, .js, .jsx, .mjs, .ts, .tsx, .astro, .vue, .svelte, .md und .mdx Dateien, überspringt die Ordner node_modules, .git, dist, build, .next, .astro, .output, .vercel und .wrangler und überspringt jede Datei über 1 MB. Jede Zeile wird gegen 25 Regeln geprüft. Ein Befund wird als datei:zeile [regel-id] nachricht gefolgt von einer fix: Zeile ausgegeben. Exit-Code 1 bedeutet, dass etwas gefunden wurde, 0 bedeutet, dass nichts gefunden wurde, 2 bedeutet einen falschen Pfad oder eine falsche Verwendung. --self-test prüft den Scanner selbst.

Da er Markdown liest, meldet er auch Phrasen, die in Notizen, Berichten, dem Brief und früheren Prüfungen zitiert werden. Ignorieren Sie jeden Befund in einer Datei, die kein Seitenquelltext ist: landing/*.md, READMEs, Notizen, frühere review.md-Dateien.

Behandeln Sie jeden Befund als Aufforderung zum Hinsehen, niemals als Urteil. Öffnen Sie die Zeile, sehen Sie, was sie tatsächlich enthält und was die Seite damit macht, und entscheiden Sie erst dann. Beschreiben Sie, worauf die Regel zutraf: Ein Palettentreffer bei einer Tag-Farbe ist kein Befund über den Seitenhintergrund. Beispiele dafür, was das Hinsehen entscheidet:

  • dead-anchor bei einem Logo-Link ist ein geringfügiger Build-Fehler. Beim Haupt-Call-to-Action bedeutet es, dass die Conversion nicht funktioniert: ein Blocker.
  • overused-font bedeutet, dass eine gängige Schriftart die Hierarchie anführt. Es ist nur dann ein Befund, wenn direction.md keinen Grund angibt und die Schriftart nicht mit einer unverwechselbaren Display- oder Monospace-Schriftart kombiniert wird.
  • palette-cream-terracotta wird bei zwei exakten Hex-Werten ausgelöst. Creme allein ist nie ein Indiz; das Bündel aus Creme, Terrakotta-Akzent und einer modischen Serife ist es.

Ein sauberer Scan beweist nichts. Erfundene Behauptungen, eine Seite, die ohne JavaScript leer ist, ein überdimensioniertes Bündel und ein Call-to-Action, der auf eine gültige ID innerhalb der Seite verlinkt, aber nie zu einem Kauf führt, hinterlassen alle kein Muster im Quellcode. Die meisten Fehler sind Abwesenheiten, Anzahlen, Widersprüche, Komposition und defektes Verhalten, die ein zeilenweiser Regex nicht sehen kann. Eine Seite kann sauber scannen und in jedem anderen Durchlauf fehlschlagen.

Lesen Sie also nach dem Scan den Quellcode selbst. Die Prüfungen, die durch Lesen durchgeführt werden, sind in references/rubric.md mit „source“ gekennzeichnet. Diejenigen, die am meisten abfangen:

  • Der <head>: title, lang, Meta-Beschreibung, Favicon, Open Graph Tags.
  • Jedes Formular: Wohin es sendet, was der Handler mit den Daten macht und ob die Erfolgsmeldung auf den Server wartet.
  • Jeder Call-to-Action href: Wohin er tatsächlich führt.
  • Schriftarten: Wird jede font-family durch ein @font-face, einen Stylesheet-Link oder einen Framework-Schriftimport geladen, oder handelt es sich nur um einen System-Stack?
  • Jede Behauptung, Zahl, Name, Spezifikation und jedes Versprechen auf der Seite, geprüft gegen den Brief. Jedes Asset, das der Brief als geliefert angibt, geprüft gegen das, was die Seite zeigt.
  • CSS, das sich selbst aufhebt, z. B. eine Container-Klasse, deren padding-Kurzschreibweise spezifischer ist als die Abschnittsregel und stillschweigend den vertikalen Abstand des Abschnitts auf Null setzt. Bestätigen Sie im Browser, indem Sie das berechnete Padding lesen.
  • prefers-reduced-motion: Vorhanden oder nicht und was es tut.
  • Der Body des erstellten HTMLs: Wenn es ein leeres `<div id=

Individual skills in this repo

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

Verwandte Skills