Communitygithub.com

turtleneck

Design-Skill für Web- und App-UI, das erkennt, was gebaut wird (Landingpage, Dashboard, App, etc.) und automatisch einen passenden Stil-Preset auswählt – mit Rezepten für HTML/CSS, Tailwind (v3/v4, shadcn) und SwiftUI.

Was ist turtleneck?

turtleneck ist ein KI-gestütztes Design-Skill, das den passenden visuellen Stil für Webseiten, Apps, Dashboards, Dokumentationen und mehr auswählt. Es analysiert die Anwendung anhand von Signalen wie npm-Abhängigkeiten, Routen, Markenwünschen und Produktkategorie und wählt dann einen von über zehn Presets aus – von keynote (ruhig, premium) bis drive (Automotive). Jeder Preset ist ein CSS-Variablen-Override auf einem gemeinsamen Kern (tokens.css) und basiert auf fünf großen Referenzseiten einer Kategorie. Das Skill enthält fertige Rezepte für HTML/CSS, Tailwind v3/v4, shadcn und SwiftUI, sowie Testwerkzeuge für responsive Ansichten und Überlaufprüfung. Es wird aktiviert, wenn der Benutzer ein neues Design erstellt, eine Seite umgestaltet oder bewertet, und ersetzt dabei generische „Vermeide KI-Standards“-Skills wie frontend-design. Die Benennung und der Workflow sorgen für Disziplin: Markenidentität respektieren, Kopie zuerst schreiben, Sektion für Sektion bauen, auf allen Testbreiten prüfen.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/n-stau/turtleneck/tree/main/skills/turtleneck

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht turtleneck?

Wähle den richtigen Look für die App und baue ihn diszipliniert auf. Jeder Look ist ein Preset: eine Datei mit variablen Überschreibungen auf einem gemeinsamen Kern. Der Standard-Preset, keynote, ist der Kern selbst. Jeder andere Preset ist eine Mischung aus fünf großen Seiten einer Kategorie, niemals eine Kopie einer davon.

Wenn dieses Skill aktiv ist, überschreibt es generische „Vermeide KI-Standards“-Skills (wie frontend-design) dort, wo sie abweichen: Bei keynote sind die Systemschriftart, Satzfall-Eyebrows und tonale Gradient-Überschriften korrekt.

Dateien neben dieser:

  • tokens.css: der Kern und die keynote-Werte. Jede Farbe ist light-dark(hell, dunkel); color-scheme auf :root, .a-dark, .a-light oder data-theme wählt die Hälfte aus. Alle Preset-Hooks sind im :root aufgelistet. Gemeinsame Komponenten leben dort auch: Schrift-Skala, Buttons, Kacheln, .a-grid, .a-rail, .a-stats, .a-reveal.
  • styles/<preset>.css: variable Überschreibungen plus ein paar preset-spezifische Regeln. Wird nach tokens.css geladen.
  • styles/<preset>.md: eine Seite pro Preset: wann verwenden, Token-Tabelle, Regeln, Komponenten-Deltas, Schriftarten, vermeiden, Checkliste.
  • recipes-html.md: Seiten-Skeleton, Navigationen, Hero, Kacheln, Bento, Galerie, Vergleich, Footer (Akkordeon auf Telefonen), Reveal und die gemeinsamen Preset-Muster (geflippte Bänder, Such-Hero, Rails, Spezifikationstabelle, Plankarten, Code-Rahmen).
  • tailwind.md, swiftui.md: die gleichen Tokens für diese Stacks.
  • test-widths.html?src=<url>[&h=800][&full=1]: die Seite bei 320/375/414 nebeneinander mit einem Überlaufbericht; full=1 vergrößert jeden Frame auf seine Dokumentenhöhe für ganzseitige Telefon-Screenshots.
  • example.html und ../../demos/ im agent-skills-Repo: fertige Seiten.

Schritt 0: Erkenne den App-Typ (obligatorisch, vor jedem Code)

  1. Ein bestehendes Designsystem oder eine explizite Stil-Anfrage gewinnen. Projekt-Tokens, eine Komponentenbibliothek-Theme, ein Markenleitfaden oder „mach es dunkel und rot“: verwende das, behalte nur die Kernregeln unten, überspringe die Tabelle.
  2. Lies die Signale: die Anfrage; README; Abhängigkeiten (package.json, pyproject.toml, Podfile, Package.swift, Gemfile, *.csproj); Routen; vorhandenes CSS; die Produktkategorie und Zielgruppe.
  3. Wähle EINEN Preset:
KategorieSignale (Anfrage, Produkt, Abhängigkeiten, Routen)Preset
Premium-HardwarePhysisches Produkt, Verbrauchergerät, Lifestyle-Gadget, Launch-Seite, „sauber“, „minimal“, „premium“; SwiftUI-Marketing-Screens; kein klares Signalkeynote
GeschäftssoftwareBüro/Produktivität, B2B, CRM/ERP, Intranet, IT/Compliance, Gesundheitswesen; Abhängigkeiten @fluentui/*, @microsoft/teams-js, office-addin-*, @azure/*, Blazor/.NET; Routen /admin, /settings, /reportsenterprise
StreamingVideo, Film/TV, Serien, Trailer, Live-Events, VOD; Abhängigkeiten hls.js, video.js, shaka-player, @mux/*, react-player; Routen /watch, /browse, /titlecinema
Musik & SocialMusik/Audio, Playlists, Kreative, Social-Feed, Dating, Fitness-Kurse, Jugend-Abo; Abhängigkeiten howler, tone, wavesurfer.js, expo-av; Routen /player, /playlist, /profilevibe
Gaming-HardwareGPU/PC-Teile, Konsolen, Peripherie, Esports, Benchmarks, Treiber, „FPS“; Abhängigkeiten three, @react-three/fiber + Chart-Bibliotheken; Routen /specs, /compare, /driverspower
Entwickler & CloudAPI, SDK, CLI, Hosting, Deploy, Datenbank, Observability, Zahlungs-API, „für Entwickler“; Abhängigkeiten next, @radix-ui/*, stripe, prisma, drizzle, trpc, turbo; Routen /docs, /changelog, /pricingdevtool
KIModell, Assistent, Chat, Agents, „KI-gestützt“ als Produkt; Abhängigkeiten openai, @anthropic-ai/sdk, ai, langchain, transformers; Routen /chat, /research, /modelslab
ReisenUnterkünfte, Flüge, Fahrten, Hotels, Buchungen, Reiserouten; Datumsauswahl, Karten (leaflet, mapbox-gl); Routen /search, /stays, /trips, /bookjourney
EinzelhandelShop, Store, Katalog, Marktplatz, Warenkorb, Kasse, Angebote, Lebensmittel, Mode; Abhängigkeiten @shopify/*, @medusajs/*, @commercetools/*, snipcart, @stripe/stripe-js mit einem Produktkatalog; Routen /shop, /products, /p/, /cart, /checkout, /categorymarket
FinanzenBank, Kreditkarte, Zahlungen, Wallet, Versicherung, Kredite, Sparen, Investieren, Konto-Dashboard für Verbraucher; Abhängigkeiten plaid, react-plaid-link, @adyen/*, dinero.js, currency.js; Routen /accounts, /cards, /rates, /apply, /transfer (eine Zahlungs-API, die an Entwickler verkauft wird, ist devtool)vault
AutomobilAutos, Motorräder, E-Bikes, EV-Laden, Mobilität, Händler, Probefahrten; Konfiguratoren, Reichweiten- und Spezifikationsseiten; Routen /models, /configure, /inventory, /test-drive, /dealersdrive
SeitentypPreset (Tie-Breaker)
Docs-Seite, Changelogdevtool
Admin-Dashboardenterprise für Geschäftsanwender; devtool für entwicklergerichtete
Shopmarket; eine einzelne Premium-Produktseite ist keynote
Portfoliokeynote für Produkt-/Designarbeit; cinema für Film, Foto, Motion
Mobile App-Bildschirmkeynote für Dienstprogramme mit nativen Gefühl; vibe für Verbrauchermedien und soziale
Spiel / Spielstudiopower für kompetitive und hardware-ähnliche; cinema für geschichtengetriebene, Trailer
KI-Funktion innerhalb eines anderen Produktsdie eigene Kategorie des Produkts; lab nur, wenn KI das Produkt ist
Buchungsablauf innerhalb eines anderen Produktsjourney nur für die Such- und Ergebnis-Seiten

Benutzer-Stilwörter direkt zugeordnet: „Apple-ähnlich / premium / sauber“ = keynote; „Microsoft / Fluent“ = enterprise; „Netflix-Stil“ = cinema; „Spotify-ähnlich / TikTok-ähnlich“ = vibe; „gaming / NVIDIA-ähnlich“ = power; „Stripe / Vercel / GitHub-Stil“ = devtool; „OpenAI / Anthropic-ähnlich“ = lab; „Airbnb / Booking-ähnlich“ = journey; „Amazon / IKEA-ähnlich“ = market; „Banking / PayPal-ähnlich“ = vault; „Tesla / BMW-ähnlich“ = drive. Das Ergebnis ist die Kategorienmischung, niemals die Website dieser Firma (siehe „Marken und Assets“).

  1. Schwache oder widersprüchliche Signale: keynote.
  2. Sag die Wahl in einer Zeile vor dem Bauen, z.B. „Stil: devtool (Next.js + Prisma, Routen /docs und /pricing, an Entwickler verkauft).“ Dann lies styles/<preset>.md vollständig (keynote: styles/keynote.md).

Was ein Preset ändern darf

Nur über die Variablen in tokens.css (:root) plus ein paar eigene Regeln:

  • Schriftarten (Display, Fließtext, Mono) und die Schrift-Skala, Schriftstärken, Laufweite, Zeilenhöhe;
  • Stil von Eyebrow und Intro, Textgröße (nie unter 14px für UI, 16px für Lesetext);
  • Oberflächen- und Textfarben, hell/dunkel Standard, der eine Akzent und der Text darauf, Link- und Fokusfarbe;
  • Radien, Rahmen, Schatten, Kachelfüllung; Buttonhöhe, Abstand, Schriftstärke, Schreibung;
  • Nav-Höhe, Füllung und Unschärfe; Inhaltsbreiten, Abschnitts- und Kachelabstände;
  • Easing, Dauern, Reveal-Distanz, Hover- und Press-Feedback;
  • Bildmaterial und Kopie-Flair (in seiner md-Datei).

Alles unterhalb dieser Linie gilt für jeden Preset.

Arbeitsablauf

  1. Respektiere das Projekt. Lade tokens.css + styles/<preset>.css, oder merge das Tailwind-Theme, oder füge die SwiftUI-Palette hinzu. Ein Preset kann die kostenlosen Schriftarten verlinken, die seine md-Datei nennt; die Seite muss trotzdem mit dem Fallback-Stack richtig aussehen. Füge niemals eine npm-Abhängigkeit für Styling hinzu.
  2. Schreibe den Seitenplan in 3 Zeilen: die eine Sache, die die Seite verkauft, die Reihenfolge der Abschnitte mit Hintergründen und den einen „Moment“ (ein geflipptes Kapitel, eine große Stat-Bento, eine Demo, ein Video, Sticky-Scroll).
  3. Schreibe zuerst den Text: Headline kurz (der Preset setzt die Länge), eine Subhead-Zeile, Intro maximal zwei Zeilen.
  4. Baue aus den Rezepten, Abschnitt für Abschnitt.
  5. Verifiziere bei jeder Testbreite (Responsive), hell und dunkel, wo der Preset beides hat: Screenshot, Überlaufprüfung, Checkliste. Korrigiere, bevor du „erledigt“ meldest.

Kernregeln

Schrift

  • Eine Familie für UI (plus Mono nur für echten Code, Tasten und API-Werte). Die Schriftstärke für Display kommt vom Preset.
  • Die Laufweite wird enger, je größer die Schrift; Fließtext wird niemals negativ über -0,022em gelaufweitet.
  • Display-Größen sind fluid clamp(min, rem + vw, max); mische immer rem in den mittleren Term.
  • Fließtext 16-17px zum Lesen; 14px nur in dichtem UI, Metazeilen und Fußzeilen. Zeilenhöhe 1,45-1,6 für Fließtext.
  • text-wrap: balance bei Überschriften; lange Wörter umbrechen (overflow-wrap, hyphens).
  • Wichtige Zahlen sind groß und verwenden tabellarische Ziffern; ihre Labels sind klein.

Farbe

  • Markenfarben zuerst. Eine Markenfarbe vom Benutzer oder aus dem Projekt ersetzt den Preset-Akzent, der nur der Fallback ist. Der Preset bestimmt weiterhin Layout, Schrift, Radien, Dichte, Bildmaterial und Bewegung.
  • Akzent-Rezeptur (Markenfarbe oder jede Akzentänderung), einmal auf :root setzen:
    • --a-blue: die Füllung, d.h. die Markenfarbe wie angegeben (alter Name beibehalten; bedeutet „Akzent“).
    • --a-on-accent: Tinte oder Weiß, je nachdem, was 4,5:1 auf der Füllung erreicht.
    • --a-blue-hover: einen Schritt dunkler (heller bei dunklem Standard), dessen Etikett immer noch besteht.
    • --a-accent-text: light-dark(a, b), der Farbton der Marke in der Helligkeit verschoben, bis er 4,5:1 auf --a-bg und --a-bg-alt in jedem Theme erreicht. Links, Akzent-Eyebrows und der Fokusring (>= 3:1) lesen es. Presets mit einem einfarbigen Primär-Button (lab, journey) behalten die Tinte in --a-button-*; die Marke gehört trotzdem hier hin.
  • Ein Akzent, kleiner Umfang: primärer CTA, Fokus, Links, ein Logo-Zeichen, kleine Badges und „empfohlen“-Marker. Keine großen Flächen oder Fließtext, es sei denn, der Preset sagt es. Statusfarben nur für Status.
  • Neutrale Oberflächen in 2-4 Stufen; Trennung durch Ton, Haarlinie oder eine weiche Schattenebene, wie der Preset sagt.
  • Text ist niemals reines Schwarz auf Weiß; Fließtext-Grau ist ein echtes Grau mit AA-Kontrast.
  • AA überall: 4,5:1 für Text und für Button-Labels auf ihrer Füllung, 3:1 für großen Text, Symbole und Rahmen, die Bedeutung tragen.
  • Dunkelmodus ist eine andere Palette, keine invertierte: einen Ton heller für erhöhte Oberflächen, keine Schatten für Tiefe.

Layout und Rhythmus

  • Inhalte haben Grenzen: eine Textspalte (--a-content) innerhalb eines breiten Grids (--a-content-wide), fließende Abstände.
  • Abschnitte wechseln zwischen Seiten- und Alternativfarbe; Kacheln nehmen die entgegengesetzte Füllung ihres Abschnitts.
  • Zentrierte Helden und Abschnittsöffner, wenn der Preset es sagt; Text in Kacheln und langer Kopie ist linksbündig.
  • Ein Moment pro Seite; höchstens ein geflipptes (dunkles oder helles) Kapitel, es sei denn, der Preset basiert auf Bändern.

Responsive (harte Regel: jede Auflösung, jeder Preset)

  • Fließende Schrift und Abstände aus den Clamp-Tokens; kleiner Wert bei 375px, großer bei 1440px.
  • Keine festen Breiten oder Höhen, die brechen können: max-width + Abstand, min(), minmax(0, 1fr), aspect-ratio, min-height. Niemals 100vh (verwende svh/dvh). Flex/Grid-Kinder, die Text enthalten, bekommen min-width: 0.
  • Grids fließen nach Platz um: repeat(auto-fit, minmax(min(100%, 20rem), 1fr)), keine Geräte-Breakpoints.
  • Medien skalieren: max-width: 100%; height: auto; SVGs behalten eine viewBox.
  • Navigation: unter 834px (oder sobald 6+ Links nicht mehr passen: Container Query) wandern Textlinks in ein Vollbild-Menü (natives popover, kein JS); verstecke ihre <li> mit einer Regel, die die Basis-Link-Stile überschreibt (Rezepte: Globale Nav). Behalte das Zeichen, die Suche und eine Aktion sichtbar. Keine Textlinks (nur Suche, Konto, Warenkorb): kein Burger.
  • Keine horizontale Scrollleiste bei keiner Breite; nur bewusste Scroller (Galerien, Rails, Code) überlaufen innerhalb ihrer eigenen Box.
  • Touch-Ziele >= 44x44px: kleine Pillen, Farbmuster, Paddles, Nav-Links bekommen einen unsichtbaren Trefferbereich (.a-hit).
  • Sichere Bereiche: viewport-fit=cover; Abstände und unterer Abstand verwenden env(safe-area-inset-*).
  • Sehr große Bildschirme: Schrift und Inhalt stoppen an ihren Grenzen; Hintergründe bleiben randlos.
  • Telefon im Querformat: Der Held darf nicht die Viewport-Höhe benötigen; nichts Aufklebendes bedeckt mehr als ein Drittel.
  • Zoom 200%: entspricht einem halb so breiten Viewport; alles fließt um, nichts abgeschnitten.

Teste Breiten, bevor du „erledigt“ sagst (Browser-Pane: resize_window auf jede, Screenshot, plus document.documentElement.scrollWidth === innerWidth und eine Liste von Elementen breiter als der Viewport):

BreiteSteht für
320kleine Telefone, 200% Zoom von 640
375 / 414Standard / großes Telefon
768 / 1024Tablet Hochformat / Querformat, kleines Laptop
1280 / 1440Laptop / Desktop (Referenzbreite)
1920 / 2560Full HD / QHD, Ultraweit
812x375Telefon Querformat
6401280px bei 200% Zoom

Bericht pro Breite: Screenshot gemacht, Überlauf ja/nein, was behoben wurde. Headless Chrome klemmt Fenster unter 500px ein; teste Telefonbreiten im Browser-Pane oder mit test-widths.html?src=<Seiten-URL> (gleicher http-Root). Headless-Aufnahmen: erzwinge das Theme mit data-theme="light|dark" auf <html>; Reveal-Inhalt ist in statischen Aufnahmen unsichtbar, also übergib --virtual-time-budget=5000 oder setze data-reveal="off" auf <html>; ein 100svh-Held dehnt sich in einem hohen Vollbildfenster aus, also fixiere es (min-height: 800px) für die Aufnahme (&full=1 macht beides).

Komponenten

  • Buttons: min Höhe 44px (kleinere Visuelles bekommen den Trefferbereich), Satzfall, es sei denn, der Preset sagt Großbuchstaben, keine Symbole außer einem nachgestellten Chevron oder Pfeil, keine Verläufe. Primär gefüllt, sekundär pro Preset.
  • Links: sichtbar als Links (Farbe oder Unterstrich); „Erfahre mehr ›“-Chevrons, wo der Preset sie verwendet.
  • Kacheln/Karten: ein Tab-Stopp, wenn die gesamte Kachel verlinkt (innerer Button ist ein span). Radius, Füllung, Rahmen und Schatten vom Preset; niemals alle von Füllung + Rahmen + Schatten gleichzeitig.
  • Fokusring: 2px solid --a-focus, Abstand 1px, auf jedem interaktiven Element.
  • Nav: solide oder Glas, je nach Preset, klebrig höchstens eine Leiste, aktuelle Seite markiert.
  • Footer: leise: kleine graue Links in Spalten, rechtliche Zeile; Spalten werden auf Telefonen zu <details>-Akkordeons.

Bildmaterial

  • Echtes Motiv: das Produkt, seine UI, die eigenen Fotos und Medien des Benutzers. Groß, mit Absicht beschnitten.
  • Keine Stock-Fotos von Leuten an Laptops, keine 3D-Kleckse, keine Emojis, keine Maskottchen, kein Symbol vor jeder Überschrift.
  • Ohne Assets: zeichne das Motiv einmal als SVG <symbol>, das durch CSS-Variablen umgefärbt wird, oder einen ehrlichen grauen Platzhalter im richtigen Verhältnis.

Bewegung

  • Übergang mit benanntem Präfix

Verwandte Skills