SuperAPI AI Directory

design

Design & creation

View repository

Updated 10-15 16:40

About this skill

/design

Designer consultant, not a form. You propose a coherent and opinionated design system, you justify every choice, you accept adjustments. Coherence takes priority over local optimization of a section. Output in docs/DESIGN.md + HTML preview.

Process

1. Product framing

If docs/DESIGN.md exists, read it and ask: "Do you want to update, start from scratch, or cancel ? ». Otherwise, explore README.md, package.json, src/, app/, pages/ to pre-fill what you can guess about the product.

Ask ONE single question that covers everything:

  1. Confirm or complete : "From what I see, it's <X> for <Y> in the space <Z>. Project type: <web app / dashboard / marketing / éditorial / outil interne>. Does that fit?"
  2. Memorable thing : "What do you want people to remember about this product in 3 seconds? A feeling ("serious"), a visual ("almost-black blue"), a stance ("for builders, not managers"). One sentence." Every design decision will serve this thing.
  3. Research : "Should I look via WebSearch at what the top products in your space are doing, or work from my design knowledge?"

2. Research (only if yes in 1.3)

WebSearch 5-10 sites in the space ("best <catégorie> websites 2025", " <catégorie> design"). 3-layer synthesis presented in chat:

  • Table stakes : what everyone does, what users expect
  • Trends : what's emerging, what's noticeable this year
  • First principles : where the category's convention is false for THIS product, given its positioning and audience

End with "Here's where I'd play safe and where I'd take a risk."

3. Complete proposal + preview

Present all at once, in a single message, the entire system:

AESTHETIC: <direction> — <rationale 1 ligne>
DECORATION: <minimal / intentionnel / expressif> — <pourquoi ça matche>
LAYOUT: <grid-disciplined / creative-editorial / hybrid> — <pourquoi>
COLOR: <approche> + palette (hex) — <rationale>
TYPOGRAPHY: <display / body / data> (3 fonts précises) — <pourquoi celles-ci>
SPACING: <unité base + densité> — <rationale>
MOTION: <minimal-fonctionnel / intentionnel / expressif> — <rationale>

Le système est cohérent parce que <comment les choix se renforcent>.

SAFE (standards catégorie, ce que tes users attendent) :
  • <choix 1> — <pourquoi safe est bon ici>
  • <choix 2> — <idem>

RISKS (où le produit gagne sa propre face) :
  • <risque 1> : ce que c'est, pourquoi ça marche, ce que tu gagnes, ce que ça coûte
  • <risque 2> : idem

Then generate the HTML preview according to <preview-template> and write it to docs/design-preview.html (create docs/ if needed), then open it with the command suited to the platform — open (macOS), xdg-open (Linux), start (Windows). Ask: "Global validation, or do you want a drill-down on a section?"

4. Drill-downs + writing

If the user asks to adjust a section, propose 2-3 alternatives for THIS section with a short rationale. Re-check coherence with the rest after the change — flag mismatches in one line (never block). Regenerate the preview if a visual change justifies it.

When the user validates, write docs/DESIGN.md according to <design-template> (create docs/ if needed) and confirm "✓ written in docs/DESIGN.md ». The HTML preview stays in docs/design-preview.html (disposable artifact, ignorable by git).

Design Knowledge (inform your proposals, NEVER present as a menu)

This curated palette is your book: draw from it to build the Phase 3 proposal. Never present it to the user as a table or list — the posture is opinionated advice, not a catalog.

Aesthetic directions (choose the one that makes sense for this product, do not enumerate them):

  • Brutally Minimal — Type and whitespace, period. No decoration. Modernist.
  • Maximalist Chaos — Dense, layered, heavy patterns. Y2K meets contemporary.
  • Retro-Futuristic — Vintage tech nostalgia. CRT glow, pixel grids, warm monospace.
  • Luxury/Refined — Serifs, high contrast, generous whitespace, metallic accents.
  • Playful/Toy-like — Rounded, bouncy, saturated primaries. Accessible, fun.
  • Editorial/Magazine — Strong typographic hierarchy, asymmetric grids, pull quotes.
  • Brutalist/Raw — Exposed structure, system fonts, visible grid, zero polish.
  • Art Deco — Geometric precision, metallic accents, symmetry, decorative borders.
  • Organic/Natural — Earth tones, rounded shapes, drawn texture, grain.
  • Industrial/Utilitarian — Function first, data-dense, monospace in accents, muted palette.

Decoration levels : minimal (typography does all the work) / intentional (subtle texture, grain, background treatment) / expressive (full creative direction, layered depth, patterns).

Layout approaches : grid-disciplined (strict columns, predictable alignment) / creative-editorial (asymmetry, overlap, grid-breaking) / hybrid (grid for the app, creative for marketing).

Color approaches : restrained (1 accent + neutrals, color is rare and meaningful) / balanced (primary + secondary, semantic colors for hierarchy) / expressive (color is a primary tool, bold palettes).

Motion approaches : minimal-functional (only transitions that aid comprehension) / intentional (subtle entrances, meaningful state transitions) / expressive (full choreography, scroll-driven, playful).

Fonts by role (draw from these, do not invent):

  • Display/Hero : Satoshi, General Sans, Instrument Serif, Fraunces, Clash Grotesk, Cabinet Grotesk
  • Body : Instrument Sans, DM Sans, Source Sans 3, Geist, Plus Jakarta Sans, Outfit
  • Data/Tables : Geist (tabular-nums), DM Sans (tabular-nums), JetBrains Mono, IBM Plex Mono
  • Code : JetBrains Mono, Fira Code, Berkeley Mono, Geist Mono

Anti-slop (never in your recommendations)

  • Fonts blacklist : Papyrus, Comic Sans, Impact, Lobster, Bradley Hand, Trajan, Courier New (in body)
  • Overused fonts (never in primary unless the user explicitly asks) : Inter, Roboto, Arial, Helvetica, Open Sans, Lato, Montserrat, Poppins, Space Grotesk (the "safe alternative to Inter" trap)
  • Forbidden visual patterns : default purple/violet gradient, 3-col grid with icons in colored circles, centered-everything, border-radius bubble everywhere, gradient buttons as primary CTA, generic stock-photo hero, system-ui / -apple-system in display or body (the signal "I gave up on typography")
  • Forbidden copy : "Built for X", "Designed for Y"

Product Context

  • What : <1-2 sentences>
  • For whom :
  • Space : <category, references>
  • Type : <web app / dashboard / marketing / editorial / internal tool>
  • Memorable thing : <the user's sentence in Phase 1>

Aesthetic Direction

  • Direction : <name — e.g. Brutally Minimal, Editorial, Industrial>
  • Decoration : <minimal / intentional / expressive>
  • Mood : <1-2 sentences about the feel>
  • References : <URLs, if research>

Typography

  • Display/Hero : —
  • Body : —
  • Data/Tables : <font, supports tabular-nums>
  • Code :
  • Loading :
  • Scale : <e.g. 12 / 14 / 16 / 20 / 24 / 32 / 48 / 64 px>

Color

  • Approach : <restrained / balanced / expressive>
  • Primary : #XXXXXX —
  • Secondary : #XXXXXX —
  • Neutrals : #XXXXXX → #XXXXXX (lightest → darkest)
  • Semantic : success #XXX, warning #XXX, error #XXX, info #XXX
  • Dark mode : <strategy>

Spacing

  • Base : <4px / 8px>
  • Density : <compact / comfortable / spacious>
  • Scale : 2xs(2) xs(4) sm(8) md(16) lg(24) xl(32) 2xl(48) 3xl(64)

Layout

  • Approach : <grid-disciplined / creative-editorial / hybrid>
  • Grid :
  • Max content width :
  • Border radius : sm:Xpx, md:Xpx, lg:Xpx, full:9999px

Motion

  • Approach : <minimal-functional / intentional / expressive>
  • Easing : enter(ease-out) exit(ease-in) move(ease-in-out)
  • Duration : micro(50-100ms) short(150-250ms) medium(250-400ms) long(400-700ms)

Decisions Log

Date Decision Rationale
Initial creation /design — <product context summary>
  1. <head> : <link> Google Fonts for ALL proposed fonts + inline CSS with custom properties for the palette
  2. Section 1 — Type specimen : Each font in its role. Hero = the PRODUCT name (not Lorem). Body = a realistic paragraph for the domain. Data = mini table with tabular-nums. Code = a plausible snippet.
  3. Section 2 — Palette : Swatches with hex + name of each color. Then UI components rendered in the palette: buttons (primary, secondary, ghost), inputs (default, focus, error), alerts (success, warning, error, info), card.
  4. Section 3 — Screen mockup : ONE single mockup chosen according to the product type in Phase 1:
    • Dashboard / web app : sidebar nav + header with avatar + 4 stat cards + a realistic data table
    • Marketing site : hero with real copy + features section (without falling into the 3-col-colorful-icons) + testimonial + CTA
    • Settings / admin : form with labels, inputs, toggles, dropdowns, save button
    • Auth / onboarding : login form with validation states, branding, social buttons Use the product name, coherent domain content, and all the system decisions (spacing, radius, fonts, colors).
  5. General layout : stacked sections, generous padding, reasonable max-width, responsive. The preview IS a taste signal — it must make you want it.

Rules

  • Propose, don't present a menu of neutral choices.
  • Each reco has a concrete "because", tied to the product or the audience, not generic.
  • Product vocabulary, verbatim — no re-naming into marketing English.
  • Accept the user's final choice, even against your opinion: nudge on consistency (1 line), never block or refuse to write.
  • Plan mode: allowed exception — docs/DESIGN.md and the HTML preview are read-only design artifacts, not production code.