Communitygithub.com

Hallmark

Ein Design-Skill für KI-Coding-Assistenten, das dafür sorgt, dass generierte UIs „gemacht“ und nicht „generiert“ aussehen. Optimiert für Anti-AI-Slop-Design und strukturelle Vielfalt.

Was ist Hallmark?

Hallmark ist ein spezialisiertes Design-Skill für KI-Coding-Assistenten wie Claude Code, Cursor und Codex, das sich der Bekämpfung von „AI Slop“ – also generischen, vorhersehbaren KI-generierten Designs – widmet. Es erzwingt einen strengen Kodex aus sechs Disziplinen, darunter eine obligatorische Vorab-Selbstkritik vor jeder Ausgabe, ein Verbot erfundener Metriken oder Testimonials, die Vermeidung von nachgeahmten Browser- oder IDE-Chrome-Frames sowie eine lückenlose mobile Reaktionsfähigkeit. Das Skill unterstützt vier Hauptbefehle: Default (Design einer neuen Seite), Audit (Bewertung einer Seite gegen eine Liste von Anti-Patterns), Redesign (Neugestaltung einer bestehenden Seite unter Beibehaltung der Inhalte und Architektur) und Study (Analyse des „Design-DNA“ eines Screenshots oder einer URL, um sie zu diagnostizieren oder wiederzuverwenden). Es verwendet einen Katalog von 20 benannten Farbschemata und Schriftpaaren, die per Rotation ausgewählt werden, und bietet einen optimierten Ablauf für reine Komponentendesigns (z. B. Buttons, Modals) mit einem obligatorischen 8-States-Demo-Wrapper.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Tantless/mine-mail/tree/HEAD/.agents/skills/hallmark

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Hallmark?

Ein Design-Skill für KI-Coding-Assistenten. Sorgt dafür, dass die von ihnen generierten UIs „gemacht“ und nicht „generiert“ aussehen.

Hallmark ist bewusst meinungsstark, kurz und absichtlich langweilig. Es kodiert einen engen Satz von Regeln – entnommen aus dem Konsens des Anti-AI-Slop-Designfeldes (Anthropics Frontend-Design-Skill, das Claude-Kochbuch zur Frontend-Ästhetik und die 2026er „taktile Rebellion“-Bewegung) – und verweigert dem Modell die Möglichkeit, auf die Standardeinstellungen zurückzufallen, auf die jedes LLM trainiert wurde.

Der Unterschied: Hallmark besteht auf struktureller Vielfalt, nicht nur auf visueller Vielfalt. Zwei Seiten von Hallmark für zwei verschiedene Briefings sollten nicht denselben Hero → 3-Features → CTA → Footer-Rhythmus teilen. Sie sollten sich wie verschiedene Websites anfühlen, nicht wie verschiedene Farbvarianten derselben Vorlage. Siehe references/structure.md.

Angetrieben von Together AI.


So verwenden Sie dieses Skill

Hallmark hat ein Standardverhalten und drei explizite Verben.

AufrufWas es tut
(Standard)Der Benutzer hat Sie gebeten, etwas Neues zu entwerfen oder zu bauen. Befolgen Sie den untenstehenden Design-Ablauf.
hallmark audit <ziel>Lesen Sie das Ziel, bewerten Sie es anhand der Anti-Pattern-Liste und geben Sie eine priorisierte Aufgabenliste zurück. Nicht bearbeiten.
hallmark redesign <ziel> [--mood <name>]Nehmen Sie den Inhalt und die Absicht des Ziels und gestalten Sie die visuelle Struktur innerhalb der bestehenden Implementierungsgrenzen neu, es sei denn, der Benutzer bestätigt explizit einen vollständigen Neubau. Neuer Abschnittsrhythmus, neue Überschriftenplatzierung, neue Komponentenstimme. Bewahren Sie bestehende Routen, Komponenteninhaberschaft, Kopierabsicht, Marke und Informationsarchitektur; ersetzen Sie nur die visuelle/Interaktionsebene, die für den angeforderten Umfang benötigt wird.
`hallmark study <screenshotURL>`

Wenn der Benutzer etwas eingibt, das nicht eindeutig auf audit, redesign oder study abbildet, behandeln Sie es als Standard. Wenn der Benutzer ein Bild anhängt oder eine URL ohne Verb-Präfix einfügt, fragen Sie: „Soll ich dies studieren (die DNA extrahieren), oder soll ich es als Referenz für einen Neubau behandeln?“

Implementierungssicherheitsschiene. Hallmark ist ein Design-Skill, keine Lizenz, eine Codebasis zu überrollen. In jedem bestehenden Projekt:

  • Löschen Sie niemals Produktionsdateien, Routenbäume, Komponentenverzeichnisse oder eine alte Website, es sei denn, der Benutzer bittet explizit um Löschung oder genehmigt einen dateiübergreifenden Plan, der die Löschungen auflistet.
  • Standardmäßig werden benannte Dateien direkt bearbeitet oder neue Komponenten/Tokens hinzugefügt, die durch die bestehende Route verdrahtet werden. Wenn das Redesign das Entfernen mehrerer Komponenten erfordern würde, halten Sie an und fragen Sie zuerst nach Bestätigung.
  • Behandeln Sie PDFs, README-Dateien, .md-Briefings, Dokumente, Transkripte und Pitch-Decks als Referenzmaterial. Kopieren Sie sie nicht wortwörtlich auf die Seite, es sei denn, der Benutzer sagt explizit, diesen Text wörtlich zu verwenden.
  • Geben Sie vor der Bearbeitung die genauen Dateien an, die Sie voraussichtlich ändern/erstellen/löschen werden. Löschungen erfordern explizite Bestätigung.

Der Standard-Design-Ablauf wählt immer ein Thema. Standardmäßig wählt er eines der 20 benannten Themen – den Katalog – und rotiert sie gemäß der Diversifizierungsregel. Es gibt auch einen ruhigen benutzerdefinierten Zweig, der eine einmalige OKLCH-Palette + freie Schriftpaarung für das Briefing erstellt; die benutzerdefinierte Route wird nur ausgelöst, wenn das Briefing ein Signal für kreative Absicht trägt (der Benutzer nennt eine Markenfarbe, nennt eine Multi-Attribut-Stimmung, die der Katalog nicht tragen kann, oder bittet explizit um ein benutzerdefiniertes Thema). Für einfache Briefings sieht der Benutzer nie die Wörter „Katalog“ oder „benutzerdefiniert“ – der Katalog läuft still. Siehe Schritt 1 (Signalerfassung) und Schritt 2.6 (Dispatch); das Protokoll lebt in references/custom-theme.md.


Disziplinen, die für jedes Verb gelten

Diese sechs Disziplinen sind nicht verbspezifisch. Sie gelten gleichermaßen für den Standard-Design, audit, redesign, study und den Komponentenumfang. Sie stehen neben dem Slop-Test, nicht innerhalb eines Zweigs davon.

  1. Vorab-Selbstkritik. Vor der Rückgabe einer Ausgabe bewerten Sie sie auf einer Skala von 1–5 in sechs Achsen – Philosophie, Hierarchie, Ausführung, Spezifität, Zurückhaltung, Vielfalt. Alles < 3 löst einen Überarbeitungsdurchlauf aus. Stempeln Sie die sechs Bewertungen oben im Artefakt (/* Hallmark · pre-emit critique: P5 H4 E5 S4 R5 V5 */). Siehe references/slop-test.md § Vorab-Selbstkritik.

  2. Ehrliche Kopie – keine erfundenen Inhalte. Wenn der Benutzer keine Metrik geliefert hat, erfinden Sie keine. Statistikgeführte Layouts, Vergleichszeilen und Beweisbalken müssen reale Zahlen verwenden, einen Platzhalter (— plus einen beschrifteten grauen Block, „zu bestätigende Metrik“) oder eine andere Makrostruktur. „+47 % Conversion“, „vertraut von über 50.000 Teams“ und „10× schneller“ sind Slop, sobald sie erfunden sind. Gleiche Regel für Testimonials, Logos und Fallstudienanzahlen. Siehe references/anti-patterns.md § Erfundene Metriken und Slop-Test-Gate 46.

  3. Gesperrte Tokens – keine Improvisation während des Renderings. Sobald ein Thema in Schritt 2.6 ausgewählt wurde, muss jede Farb- und jede font-family-Deklaration im Artefakt auf ein benanntes Token verweisen (var(--color-accent), font-family: var(--font-display)). Inline-OKLCH / Hex / rgb()-Werte oder eine font-family: "Some Font"-Deklaration, die den Token-Block umgeht, sind nicht erlaubt. Wenn ein Wert benötigt wird, der nicht als Token existiert, heben Sie ihn als neue benannte Variable in den Token-Block und verweisen Sie dann darauf. Siehe references/anti-patterns.md § Token-Improvisation während des Renderings und Slop-Test-Gate 48.

  4. Nachgebaute Chrome verboten. Hallmark darf keine fake Browser-Leisten (URL-Pille + Verkehrslicht-Punkte), fake Telefonrahmen, fake Code-Block-Fenster (Mock-Titel-Leiste + Punkte, die ein <pre> umschließen) oder fake IDE-Chrome von Hand erstellen – die Umgebung des Benutzers liefert bereits echte Chrome. Verwenden Sie echte Screenshots, die in ein <figure> gewickelt sind (mit höchstens einem haarfeinen Rand), oder lassen Sie die Chrome weg und lassen Sie den Inhalt für sich selbst sprechen. Siehe references/anti-patterns.md § Nachgebaute UI-Chrome und Slop-Test-Gate 47.

  5. Mobile Reaktionsfähigkeit – jede Ausgabe bei 320 / 375 / 414 / 768 px verifiziert. Die Ausgabe von Hallmark muss auf allen vier Breiten einwandfrei rendern. Die nicht verhandelbaren Bedingungen: kein horizontaler Scroll + Root overflow-x: clip sowohl auf html als auch auf body, niemals hidden (Gate 34); kein zweizeiliger klickbarer Text – Buttons, primäre Nav-Links, Footer-Links, Breadcrumbs, CTAs (Gate 49); bildtragende Grid-Spuren verwenden minmax(0, 1fr), niemals reines 1fr (Gate 50); Display-Überschriften umbrechen innerhalb langer Wörter über overflow-wrap: anywhere; min-width: 0 (Gate 51); Abschnittsüberschriften brechen auf Mobilgeräten auf eine Spalte zusammen, und zwar über alle Themenvarianten hinweg (Gate 52); Radio-Tab-Muster springen nicht beim Scrollen (Gate 53). Siehe references/responsive.md § Mobil – nicht verhandelbar. Dies ist eine harte Untergrenze, keine Wunschliste.

  6. Typografie-Reinheit – keine kursiven Überschriften. Überschriften und Display-Typografie sind immer römisch (font-style: normal). Ein kursivisiertes Betonungswort innerhalb einer ansonsten aufrechten Überschrift (Gebaut, um zu <em>denken</em>) ist eines der zuverlässigsten KI-Merkmale; ebenso eine vollständig kursive Display-Schriftart für Überschriften. Transportieren Sie Betonung durch Gewicht, Akzentfarbe oder eine gezeichnete Unterstreichung. Kursiv überlebt nur als Fließtext-Betonung innerhalb von laufenden Absätzen. Siehe references/anti-patterns.md § Kursive Überschriften und Slop-Test-Gate 38a.


Wenn das Briefing eine Komponente ist, keine Seite

Bevor Sie den vollständigen Design-Ablauf durchlaufen, prüfen Sie den Umfang. Wenn eines dieser Signale ausgelöst wird, führen Sie stattdessen den Komponenten-Umfang-Ablauf aus – die meisten alltäglichen Entwicklungsanfragen sind komponentenförmig, nicht seitenförmig, und der Apparat auf Seitenebene (Makrostruktur, Hero-Anreicherung, Footer-Archetyp, Projektgedächtnis) ist falsch für sie.

Signale für Komponentenumfang:

  • Das Briefing nennt ein einzelnes UI-Element: ein Button · ein Input · eine Karte · ein Modal · ein Dropdown · ein Tooltip · ein Select · eine Checkbox · ein Switch · eine Tab-Leiste · ein Chip · ein Badge · ein Banner · ein Snackbar · ein Popover · ein Slider · ein Date Picker · ein Avatar.
  • Das Briefing ist kurz (≤ 30 Wörter) und bezieht sich auf ein Element.
  • Die Zieldatei ist eine einzelne Komponente (z. B. ./Button.tsx, ./components/Input.css, app/components/Card.vue).
  • Der Benutzer sagt explizit „nur das X“, „nur das Y“, „dieses eine Element”, „ein einzelnes ___“.

Wenn zwei Signale ausgelöst werden, leiten Sie zur Komponente um. Wenn nur der Seitenablauf ausgelöst wird (Multi-Section-Briefing, „baue mir eine Landing Page“), bleiben Sie im Design-Ablauf.

Was der Komponentenumfang vom Seitenablauf behält

  • Schritt 0 · Pre-Flight-Scan – gleich. Bestehende Tokens, Schriftarten, Framework, Mikrointeraktionshaltung lesen. Ein Button in einem Geist-basierten Tailwind-Projekt muss diese Tokens übernehmen, nicht neue erfinden.
  • Schritt 1 · Genre-Erkennung – gleich. Redaktionell / modern-minimal / atmosphärisch / verspielt. Die Komponente erbt das Genre ihrer Umgebung (stilles Standard auf redaktionell, wenn unbekannt).
  • Schritt 2.6 · Themen-Route – gleich. Wenn eine tokens.css oder design.md existiert, verwendet die Komponente diese Tokens. Andernfalls fragt sie „gibt es ein System, dem ich folgen soll, oder soll ich eines auswählen?“ – Standard auf Katalog, wenn der Benutzer schweigt.
  • 2+1-Schrift-Disziplin – gleich.
  • Zustandsdisziplin – STRENGER. Jede interaktive Komponente MUSS Code für alle 8 Zustände liefern: Standard · Hover · :focus-visible · :active · deaktiviert · Laden · Fehler · Erfolg. Die 8-Zustände-Checkliste in interaction-and-states.md ist obligatorisch, nicht empfohlen.
  • Slop-Test – nur universelle Teilmenge. Führen Sie die visuellen / Mikrointeraktions- / Kontrast- (Gates 40–41) / Barrierefreiheits- / Typografie-Gates aus. Überspringen Sie die Diversifizierungs-Gates (kein Eintrag in .hallmark/log.json – Komponenten rotieren nicht) und überspringen Sie die Layout-Sicherheits-Gates, die eine vollständige Seite annehmen.

Was der Komponentenumfang überspringt

  • Schritt 2 · Makrostruktur-Auswahl. Komponenten haben keine Makrostrukturen. Geben Sie dies explizit an: „Komponentenumfang: Makrostruktur übersprungen.“
  • Nav- und Footer-Archetyp-Auswahl. N1–N9 und Ft1–Ft8 sind nur auf Seitenebene. Eine Komponente ist ein Element; sie hat kein Nav, keinen Footer. Beide überspringen.
  • Hero-Polish-Muster (HP1–HP4). Nur auf Seitenebene. Ein Button oder eine Karte hat keinen Hero.
  • Schritt 4 · Anreicherung. Keine Hero-Illustration, kein Demo-Video, kein abstrakter Hintergrund. Die Komponente IST das Artefakt.
  • Schritt 5 · Multi-Section-Vorschau. Ersetzt durch den 8-Zustände-Demo-Wrapper (unten).
  • Projektgedächtnis-Anhängen. Kein Eintrag in .hallmark/log.json für Komponentenläufe. Die Diversifizierungsregel gilt nicht.

Was der Komponentenumfang ausgibt

Zwei Dateien, nebeneinander:

  1. Das Komponenten-Artefakt – eine einzelne in sich geschlossene Datei, die den Konventionen des Projekts entspricht:

    • React / Vue / Svelte: Button.tsx / Button.vue / Button.svelte
    • Vanilla Web: button.css + button.html
    • Tailwind: eine .tsx mit className-Ketten UND einer tokens.css, falls fehlend
    • Die Komponente konsumiert Hallmark-Tokens beim Namen (var(--color-accent)), niemals inline-OKLCH-Werte.
  2. Ein 8-Zustände-Demo-Wrapper – <ComponentName>.preview.html (oder .preview.tsx). Eine kleine eigenständige Seite, die die Komponente in allen 8 Zuständen vertikal gestapelt rendert, jeder beschriftet. Der Benutzer öffnet sie einmal, sieht die Komponente in Aktion und löscht sie dann. Der Wrapper ist nicht Teil des Produktionscodes. Format:

    ┌──── Button — 8 Zustände ──────────────────────┐
    │                                                │
    │ default       [ Klick mich                 ]  │
    │ hover         [ Klick mich                 ]  │  ← .is-hover erzwingt :hover-Styling
    │ focus         [ Klick mich                 ]  │  ← .is-focus erzwingt :focus-visible
    │ active        [ Klick mich                 ]  │  ← .is-active erzwingt :active
    │ disabled      [ Klick mich                 ]  │  ← disabled-Attribut
    │ loading       [ ⌛ Arbeite…                ]  │  ← data-state="loading"
    │ error         [ ⚠ Versuche es erneut       ]  │  ← data-state="error"
    │ success       [ ✓ Gespeichert              ]  │  ← data-state="success"
    │                                                │
    └────────────────────────────────────────────────┘
    

    Jede beschriftete Zeile verwendet eine Klasse (z. B. .is-hover), die das CSS der Komponente zusätzlich zur echten Pseudoklasse ansteuert, sodass alle 8 Zustände gleichzeitig auf der Demoseite rendern. Beispiel:

    .btn:hover, .btn.is-hover { background: var(--color-paper-3); }
    .btn:focus-visible, .btn.is-focus { outline: 2px solid var(--color-focus); }
    .btn:active, .btn.is-active { transform: translateY(1px); }
    

Stempelformat für Komponentenausgabe

Komponenten stempeln anders als Seiten:

/* Hallmark · component: <typ> · genre: <genre> · theme: <theme>
 * states: default · hover · focus · active · disabled · loading · error · success
 * contrast: pass (46–50)
 */

Das Präfix component: teilt zukünftigen Hallmark-Läufen mit, dass dieses Artefakt auf Komponentenebene skaliert ist und keine Diversifizierung auf Seitenebene auslösen sollte.

Verwandte Skills