Communitygithub.com

zernie/vigiles

Der Zweck, der UX-Fluss und der modern-minimalistische Design-Anspruch der Landing-Seite vigiles.sh (site/). Immer dann verwenden, wenn eine site/-Komponente, ein Hero-Bereich, ein Abschnitt oder Marketing-Text entworfen, bearbeitet, hinzugefügt oder überprüft wird – vor der Bearbeitung von site/ LESEN und jede Änderung daran messen. Nicht für docs/ oder die App selbst.

Was ist vigiles?

Diese Skill definiert die UX- und Design-Standards für die Landing-Seite vigiles.sh (site/), einen Vite + React + Tailwind-Dunkelmodus-Stack, der auf vigiles.sh bereitgestellt wird. Ihr Kernprinzip lautet „Design durch Subtraktion“: Im Zweifelsfall entfernen, niemals hinzufügen – jedes Element muss sich seinen Platz verdienen. Das übergeordnete Ziel ist es, die Conversion-Rate zu maximieren, also den Prozentsatz der Besucher, die tatsächlich `npx vigiles audit` ausführen. Die Seite richtet sich an erfahrene Entwickler, die in agentischen Coding-Tools wie Claude Code, Codex oder Cursor arbeiten. Das Haupt-Wow ist der benotete Report, der als Live-Demo im Browser mit vorgefertigten Beispiel-Repos präsentiert wird. Der Report muss immer echte Scans zeigen, keine erfundenen Ergebnisse, um das Markenversprechen „gemessen, nicht behauptet“ zu wahren. Alle wichtigen Designentscheidungen sind in einem separaten Abschnitt festgehalten, der die Design-Intention bewahrt und unbeabsichtigte Änderungen verhindert. Die Skill unterstützt die Plattformen Cursor, Codex und Claude Code.

Funktioniert mit✓Claude Code✓Codex CLI✓Cursor✓Antigravity
npx skills add https://github.com/zernie/vigiles/tree/HEAD/.claude/skills/landing-site

In Ihrer bevorzugten KI fragen

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

Dokumentation

Landing-Seite – Zweck, UX und Design-Anspruch

Das Eingangstor ist site/ (Vite + React + Tailwind, nur dunkel), bereitgestellt auf vigiles.sh. Diese Skill ist der Standard, an dem jede Änderung gemessen wird. Der wiederkehrende Fehler, den sie verhindern soll: Elemente hinzufügen anstatt sie zu entfernen, wodurch die Seite überladen und schablonenhaft („tilda-artig“) wirkt, anstatt modern.

Die eine Regel, die über allen anderen steht: im Zweifelsfall ENTFERNEN. Design durch Subtraktion. Wenn das Löschen eines Elements keine Bedeutung verliert, lösche es. Eine Änderung, die eine Box, eine Bildunterschrift, einen zweiten Button oder eine beruhigende Zeile hinzufügt, ist verdächtig, bis sie sich als notwendig erweist.

Zweck (wofür die Seite da ist)

  • OBERSTES ZIEL – den Prozentsatz der Besucher maximieren, die tatsächlich npx vigiles audit AUSFÜHREN. Das ist die EINE Conversion-Metrik, der jede Designentscheidung dient. Der CTA muss GROSSARTIG sein (reibungslos, offensichtlich, immer erreichbar). Wenn eine Änderung nicht hilft, den Befehl auszuführen, verdient sie ihren Platz nicht.
  • Zielgruppe: Entwickler, die bereits in agentischen Coding-Tools leben (Claude Code, Codex, Cursor). Sie sind skeptisch und überfliegen auf dem Smartphone.
  • Das Wow ist der benotete Report – zeige das Ergebnis, erkläre nicht den Mechanismus.
  • Das Versprechen der Eingangsseite: „Lighthouse für dein Agenten-Harness“ – eine Benotung auf einen Befehl hin, keine Konfiguration, nichts hochgeladen – deine Skills/Hooks/Subagenten/Referenzen.
  • DER DEMO-RAHMEN ÜBERNIMMT VIER AUFGABEN GLEICHZEITIG – gestalte für alle vier, lass nicht zu, dass eine die anderen verdrängt. (1) EINFÜHRUNG – vermittle auf einen Blick, was vigiles ist (der benotete Report IST der Pitch). (2) DEMO – sofortige echte Noten mit null Aufwand (die eingebauten FEATURED-Chips). (3) IM-BROWSER-AUSFÜHRUNG – benote DEIN öffentliches Repo live, indem du es eingibst (GitHub anonyme API; nur öffentlich). (4) BEFEHLS-KOPIE für den Rest – ein privates oder lokales Repo kann nicht im Browser ausgeführt werden, also ist die Aufgabe dort eine saubere, offensichtliche KOPIE von npx vigiles audit (eine Befehlsübergabe, KEIN gefakter Browser-Lauf). Zwei Klarheitsregeln ergeben sich daraus und sind tragend: (a) der Rahmen muss immer KLAR MACHEN, WELCHES Repo gezeigt wird und ob es sich um ein VORDEFINIERTES BEISPIEL (ein Chip) oder DEIN EIGENES (eingetippt) handelt – niemals mehrdeutig; (b) der private-Repo-Pfad ist ein erstklassiges Angebot, kein nachträglich in einen Satz gequetschter Gedanke – eine saubere beschriftete Befehls-Kopie, validiert bei 390px. Wiederhole den Befehl nicht in drei übereinander gestapelten Zeilen (der Header, der $ vigiles audit <slug> über einem hervorgehobenen Chip anzeigt, der ihn bereits benennt, ist ZU VIEL – der Header soll das benotete Repo + seine QUELLE IDENTIFIZIEREN, nicht den Befehl erneut drucken).
  • TEXT: konkret statt clever, und pflanze NIEMALS einen Zweifel, den der Leser nicht mitgebracht hat. Zwei echte Fehltritte, die dies verhindert: (1) eine clevere Überschrift, die kryptisch wirkt („‚Gültig‘ ist nicht ‚wahr‘“) – führe mit dem konkreten Problem an („Gültige Konfiguration. Fehlerhafter Agent.“), lass die Karten darunter die Nuancen tragen; (2) ein DEFENSIVES FAQ, das eine Schwäche hervorhebt, die der Leser nicht bemerkt hatte („Ist es stabil genug für die Einführung?“ lenkt den Blick auf eine beängstigende Versionsnummer) – ersetze Zweifel-Pflanzer durch Vertrauensbildner, die ein Skeptiker tatsächlich fragt („Verlässt irgendetwas meinen Rechner?“, „Kann ich ein privates Repo benoten?“). Teste jede Zeile wie ein kalter Skeptiker: macht sie mich MEHR oder WENIGER wahrscheinlich, den Befehl auszuführen? Wenn weniger, streiche oder rahme neu.
  • GLAUBWÜRDIGKEIT: der Demo-Report zeigt NUR echte Scans – fabriziere niemals ein Ergebnis. Die Marke steht für „gemessen, nicht behauptet“, also vergiftet eine hartcodierte/gefälschte Zahl im Report rückwirkend das Vertrauen in jeden echten Befund. Ein GESPERRTER Teaser mit EHRLICHEN PLATZHALTERN (Gedankenstrich „zum Befüllen ausführen“, keine Ziffern) für etwas, das hier wirklich nicht ausgeführt werden kann (modellgesteuerte Triggerrate) ist in Ordnung – es fälscht NICHTS. Erfundene „Ergebnisse“ für etwas, das das Tool tatsächlich berechnet, ist NICHT in Ordnung – zeige das ECHTE berechnete Ergebnis oder behalte es als ehrliche erklärende Karte AUSSERHALB des Report-Rahmens.
  • Senke die Hürde zum Ausprobieren: biete VORBEFÜLLTE beliebte OSS-Repos als Ein-Klick- „bewerte dies“-Chips an, damit ein Besucher einen echten Report sieht, ohne etwas einzugeben oder ein eigenes Repo zu haben. UMGESETZT – die FEATURED-Chips in DemoAudit rendern eingebettete echte Reports sofort.
  • JEDE ERGEBNIS-OBERFLÄCHE TRÄGT EINE TEILEN-FUNKTION UND EINEN STABILEN LINK. Eine Note, die ein Leser nicht an ein Teammitglied weitergeben kann, ist eine Sackgasse, also: (1) jede abgeschlossene Note ist ein kopierbarer Deep-Link (vigiles.sh/?repo=owner/repo#try), der den Audit beim Laden AUTOMATISCH AUSFÜHRT – die URL IST die Teilen-Einheit; (2) jedes Ergebnis erhält ein Ein-Tippen-Teilen (systemeigenes Teilen-Blatt auf Mobilgeräten, Link kopieren woanders – die ShareRow in DemoAudit); (3) der Deep-Link ist derselbe Slug, den die Eingabe/Chips verwenden, also führen ein geteilter Link, ein eingegebenes Repo und ein Chip alle zu einem Codepfad. Eine neue Ergebnis-Oberfläche MUSS beide tragen. UMGESETZT – halte es funktionsfähig. (Die Reputationsregeln, unter denen dies funktioniert – Teilen ist freiwillig, Ablehnen ist kostenlos, Noten-Artefakte nicht Personen – sind die gate-first-adoption-Regel in der CLAUDE.md im Stammverzeichnis; wiederhole sie nicht hier.)
  • Messe die Conversion: Analysen zum Trichter (Befehls-Kopien, eingegebene Absendungen, Chip-Versuche, erneute Benotungen, Klick auf Teilen). Die Seite ist auf GitHub Pages, NICHT Vercel – also Vercel Analytics gilt NICHT. Verwende ein leichtgewichtiges, datenschutzfreundliches, Script-Tag- Analyse-Tool für statisches Hosting: Plausible / Fathom / GoatCounter. Der Trichter ist bereits INSTRUMENTIERT – track() (site/src/lib/track.ts) feuert demo_*-Ereignisse und ist eine sichere No-op, bis ein Anbieter angeschlossen ist. VERBLEIBEND: füge das Script-Tag des Anbieters in index.html ein und bestätige, dass Ereignisse ankommen. Analysen tragen nur die ERGEBNIS-Art, niemals einen eingegebenen Slug (der Name eines privaten Repos darf nicht durchsickern).

Richtung – dokumentierte Entscheidungen (aktuell halten; hier lebt die RICHTUNG)

Die strategischen Entscheidungen hinter der aktuellen Seite. Aktualisiere diesen Abschnitt, wenn sich eine Richtung ändert – es ist das Design-Dokument, nicht nur eine Stilvorlage. Jede ist eine Entscheidung, die echte Iteration gekostet hat, um sie zu erreichen; mache keine stillschweigend rückgängig.

  • DIE STANDARD-DEMO MUSS EINEN FEHLER ZEIGEN – führe mit einer echten niedrigen Note, niemals mit einer Wand von Einsen. Die FEATURED-Chips sind eine echte F → C → B → A-Skala auf BEKANNTEN Repos (derzeit davila7/claude-code-templates F, disler/claude-code-hooks-mastery C, madappgang B, obra/superpowers A). WARUM es so sein muss: echte beliebte Plugins bekommen meist A/B auf der deterministischen Achse, die der Browser ausführen kann – die dramatischen Fehler (Skills feuern nicht, Beschreibungen kollidieren) leben in der modellgesteuerten Triggerrate-Ebene, die der Browser NICHT ausführen kann – also argumentiert eine sauber aussehende Standardeinstellung GEGEN das Tool („alles in Ordnung, warum brauche ich das?“). Der Standard muss ein wirklich defektes Repo sein, damit das Wow (der Report) zeigt, dass vigiles etwas findet. Aktualisieren der niedrigen Standard-Note (Repos werden im Laufe der Zeit korrigiert): durchforste mit git clone https://github.com/<slug>, dann node dist/cli.js audit <dir> --json (HINWEIS: codeload/api.github.com sind in der Cloud-Umgebung durch Proxys blockiert – git clone über github.com funktioniert). Wähle ein Repo aus, das (a) bekannt ist, (b) OBJEKTIVE, mit einer Zeile behebbare Befunde hat (totes Tool, unsichtbares skills/-Verzeichnis, totes Hook-Ereignis – nicht absichtlich peinlich), damit die öffentliche Note fair ist (das Lighthouse-Modell IST öffentliche Noten von öffentlichen Artefakten). Backe den Report in site/src/demo/reports/ und binde ihn in FEATURED ein. Befunde auf Modellebene bleiben AUSSERHALB der Browser-Demo: sie ist deterministisch-only von Natur aus (siehe die In-Browser-Demo-Invarianten unten), also ist die ehrliche Oberfläche dafür der LockedRow-Teaser, kein erfundenes Ergebnis.
  • NAMEN-ABER-NIEMALS-ERKLÄRTEN ist der #1-Textfehler – erkläre jedes Konzept oder streiche es. Ein kalter Besucher weiß nicht, was „Linter“, „Referenz“, „Erzwingen“, „Spezifikation“ oder ein Kategoriename bedeutet. Jedes Konzept erhält eine einfache Erklärung beim ERSTEN Gebrauch, oder es wird gestrichen. Wirf nicht mit Fachjargon um dich (das ALTE README hat das gelernt – „DEFINIERE HARNESS bei der ersten Verwendung“; die Seite ist zurückgefallen und musste es neu lernen). Teste jede Zeile als kalter Claude Code/Codex-Benutzer, der noch nie von vigiles gehört hat.
  • FALTE ECHOS IN DEN REPORT – füge keine eigenständigen Erklärkarten hinzu. Der Report IST das Wow. Ein Konzept, das der Browser nicht zeigen kann (modellgesteuerte Triggerrate, die Linter- Querverweise, die deine lokale Konfiguration benötigen) ist eine gestrichelte NUR-CLI-Zeile IM REPORT (LockedRow / CliRulesRow in report-view/src/Report.tsx), keine Karte, die unterhalb des Rahmens schwebt. Wenn die Seite den Report an zwei Stellen erklärt, streiche das Echo (deshalb wurden der Wedge-Fünf-Kategorie-Streifen und die eigenständige Karte „Deine Regeln → erzwungen“ entfernt – der Report trägt bereits beides).
  • EIN EINGABE-ANGEBOT ZUMAL – Registerkarten Öffentlich/Privat, kein Stapel. Die Helden- Eingabe war Eingabe + Untertitel „öffentliche API“ + privater Befehls-Handoff + Datenschutzzeile, alle gestapelt (überladen). Es sind jetzt Registerkarten Öffentlich | Privat in DemoAudit: Öffentlich = die Live-Eingabe eines Repos als Kombinationsfeld; Privat = die Befehls-Kopie von npx vigiles audit. Ein Angebot sichtbar auf einmal.
  • EHRLICHER TEASER, NIEMALS UNSCHARF/GEFÄLSCHT (ersetzt jede ältere „rendere es unscharf“-Notiz). Die modellgesteuerte Zeile verwendet Gedankenstrich-Platzhalter (recall — · precision —), NICHT unscharfe gefälschte Zahlen. Unschärfe wird als Rendering-Fehler UND als Paywall-Dark-Pattern gelesen, und das Erfinden einer Zahl bricht „gemessen, nicht behauptet“ – doppelt falsch, wenn es in der Nähe von Text steht, der sich über erfundene Zahlen lustig macht. Wenn jemals ein stärkerer Teaser gewünscht ist, verwende eine ECHTE gemessene Zahl mit einem beispiel-Label, niemals eine erfundene/unscharfe.

UX-Anforderungen

  • Befehls-zuerst. npx vigiles audit ist die universelle Aktion (funktioniert auf jedem Betriebssystem, jedem Terminal). Es ist der PRIMÄRE CTA. Alles andere ist sekundär.
  • Der Claude Code Deeplink (claude-cli://) ist eine NUR-DESKTOP-Verbesserung, niemals der primäre Pfad – er endet stillschweigend auf mobilen Geräten / CC Web / Desktop-ohne-CC. Rendere ihn nur dort, wo er funktionieren kann; versende niemals einen Button, der nichts tut.
  • Sei ehrlich auf Mobilgeräten. Keine toten Buttons. Wo eine Desktop-only-Aktion nicht ausgeführt werden kann, sage es klar und gib die echte Aktion (den Befehl) stattdessen an.
  • Eine primäre Aktion pro Bildschirm. Sekundäre Aktionen sind leise – ein Textlink oder eine leichte Pille, niemals ein zweiter schwerer, vollbreiter Button, der mit dem primären konkurriert.
  • Harness-neutral. Sage „Claude Code oder Codex“, führe nicht mit Claude Code – es ist ein Implementierungsdetail, nicht die Überschrift. Erkläre Interna nicht übermäßig.
  • Niedrige Hürde + einladend. Ein Überflieger sollte verstehen, was es ist und wie man es innerhalb eines Bildschirms ausprobiert, ohne einen Textblock lesen zu müssen.

Design-Anspruch – modern & minimal (die Anti-Überladungsregeln)

Beziehe dich auf das Gefühl von Linear / Vercel / Raycast: selbstbewusstes Dunkel, großzügiger Raum, wenige Wörter, ein klarer Fokuspunkt pro Abschnitt. KEINE mit Funktionen vollgestopfte Vorlage.

  • Jedes Element muss sich seinen Platz verdienen. Entferne alles, was nur ein anderes wiederholt (eine Bildunterschrift, die den Screenshot wiederholt; eine Vertrauenszeile, die zweimal gesagt wird; eine redundante Unterüberschrift).
  • Streiche jedes Label, das ein anderes Element bereits IMPLIZIERT. Ein „Kostenlos & Open Source“-Abzeichen ist redundant, wenn ein GitHub/Stern-Link vorhanden ist; ein „EIN BESTIMMTES REPO AUDITIEREN“-Abzeichen über einer Überschrift „Ein bestimmtes Repo benoten“ wiederholt es. Wenn der Kontext dem Leser bereits sagt, was zu tun ist, ist das Label Rauschen.
  • Jeder Link/CTA ist HANDLUNGSORIENTIERT und spezifisch. Der Leser muss genau wissen, was beim Klicken passiert. Keine vagen oder passiven sekundären Links („Hast du Claude Code?…“). Wenn ein sekundärer Pfad eine klare, konkrete Aktion nicht wert ist, streiche ihn (oder verschiebe ihn in die Navigation, wo ein beständiger Link einen schlaffen Falzlink schlägt).
  • Ein Fokuspunkt pro Abschnitt. Das Auge sollte zuerst auf eine Sache fallen.
  • Weißraum + Typografie vor Boxen. Staple nicht 3+ vollbreite gerahmte Boxen; diese Wiederholung wirkt überladen. Bevorzuge Type-Hierarchie und Platz vor Rahmen. Aber Weißraum muss beabsichtigt sein – auch keine fast leeren Viewport-Leeren.
  • Beruhigung einmal, in einer Zeile. Vertrauenstext („nichts hochgeladen“) erscheint einmal, kompakt – niemals ein 3-zeiliger Absatz, niemals pro Abschnitt wiederholt.
  • Kohäsion. Der Held (Abzeichen + Überschrift + Unterüberschrift + visuelles Element) muss als EINE Idee gelesen werden, wobei jeder Teil neue Informationen hinzufügt. Wenn die Unterüberschrift nur sagt, was der Screenshot bereits zeigt, streiche oder schärfe sie.
  • Zurückhaltung bei Farbe/Betonung. Ein Akzent, semantische Bandfarben, die immer etwas bedeuten (Notenbänder). Fette eine Phrase pro Punkt, nicht jeden Satz. Kein dekoratives Emoji-Konfetti.
  • Konsistenter Abstandsmaßstab. Feinabstimmung einzelner Ränder, die den Rhythmus stören, vermeiden.

Anti-Patterns (Dinge, die hier schiefgelaufen sind)

  • Stapeln von Eingabe + großem Button + 3-zeiliger Vertrauenstext + Trennlinie + Befehl + Bildunterschrift + einem weiteren Button auf einer Falzebene. (Behebung: ~3 Elemente behalten, den Rest streichen.)
  • Eine Bildunterschrift unter dem Produktbild, die das Produktbild wiederholt.
  • Hinzufügen eines Hinweises/Buttons pro Problem, anstatt den Ablauf zu überdenken.
  • Zwei konkurrierende primäre CTAs (Deeplink + Befehl) ohne Hierarchie.
  • CC-zuerst-Rahmung („läuft in deinem eigenen Claude Code…“) als die primäre Beruhigung.
  • Ein Desktop-only-Ablauf (der Claude Code claude-cli:// Deeplink) blieb auf Mobilgeräten als Fallback sichtbar, der nur den Befehl wiederholt, den ein anderer Abschnitt bereits zeigt – der gleiche npx vigiles audit-Block in aufeinanderfolgenden Abschnitten auf dem Telefon. (Behebung: hidden sm:block für den gesamten Desktop-only-Abschnitt; der Held + CTA tragen es bereits.)

In-Browser-Demo (UMGESETZT – die Invarianten, die zu erhalten sind)

Die Live-„benote jedes Repo“-Demo ist GEBAUT (in DemoAudit.tsx + site/src/demo/): tippe ein öffentliches Repo ein oder tippe auf einen empfohlenen Chip, es holt die Harness-Dateien client-seitig und führt die GLEICHE kompilierte Engine aus, die auch die CLI verwendet. Die Regeln unten sind jetzt INVARIANTEN, die zu erhalten sind, keine zukünftige Richtung.

  • Jedes Ergebnis ist teilbar (siehe das Teilbarkeitsziel oben). Eine abgeschlossene Note trägt ein Ein-Tippen-Teilen + einen stabilen automatisch ausführenden ?repo=-Deep-Link. Dies ist eine harte Anforderung der Demo, kein Nice-to-have – versende keine Ergebnis-Oberfläche ohne sie.
  • Im Browser, NICHT gehostet. Die Audit-Berechnung läuft vollständig CLIENT-SEITIG im Browser des Besuchers (holt die Dateien des Repos über die GitHub-API, führt die reinen Detektoren in JS aus) → verstärkt „nichts verlässt deinen Rechner“; kein Backend/Kosten. Das einzige „Hosting“ ist die Auslieferung statischer Dateien auf vi

…

[gekürzt für die Übersetzung]

Verwandte Skills