Skip to content

cskwork/superdesign-skill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

English | 한국어

superdesign

A master web/mobile designer as a Claude Code skill. Read the intent, pulse current trends, route to the aesthetic that fits, and ship elegant UI that passes a deterministic anti-slop gate. Self-contained and portable: works without Stitch, gpt-image-2, or web search, and degrades gracefully.

Landing page: https://cskwork.github.io/superdesign-skill

What it adds over a plain design prompt

  • Intent-driven routing. Classifies the design job into one of six modes and picks the medium + aesthetic family that fit, instead of one default house style.
  • Trend-aware, not trend-chasing. A live WebSearch trend pulse (with a dated offline snapshot fallback) keeps output current, but only trends that serve the brief are applied. The trend read is recorded with its date.
  • Anti-slop is enforced, not eyeballed. A deterministic detector (templates/anti-slop-gate.mjs) plus a WCAG contrast gate scan the built source. The designer never self-approves.
  • Graceful fallback. Missing tools degrade to documented placeholders and the baked snapshot, never faked assets or invented data.

Principles

  • Elegance is the baseline, not padding.
  • Read the intent first; design to the brief, never a default template.
  • Trend-aware is not trend-chasing; record the trend read, dated.
  • Anti-slop is enforced by gates; the designer never self-approves.
  • Self-contained with graceful fallback; never fake assets or data.
  • Hard stops: external publish or destructive steps need explicit consent.

Modes

Mode For
CREATE a new UI / landing / app / screen from scratch
REDESIGN modernize / improve an existing UI (audit-first)
SYSTEM design tokens / palette / type / theme only
CRITIQUE review / audit a design (runs the detectors, no build)
EXPLORE divergent directions / moodboard, commit to none
ASSET one image / icon / illustration / SVG / logo via the fallback chain

Medium (web vs mobile/native) is decided in the loop: reference/web.md or reference/mobile.md.

Default loop (CREATE / REDESIGN)

  1. Read the brief; state it in one line.
  2. Trend pulse - search current trends (snapshot fallback), record dated.
  3. Direction - set dials, pick one system / family / lane, pick the medium.
  4. Build to reference/taste-core.md + the chosen family/medium; source assets via the chain.
  5. Critique (independent) - run templates/preflight-gate.sh; log every violation.
  6. Verify - fix, re-run the gate until green, report with output.

Examples

/superdesign a calm landing page for a developer-tools startup
/superdesign redesign this admin dashboard to feel less generic
/superdesign a design system: tokens for a fintech app, light + dark
/superdesign critique this page  (paste code / URL / screenshot)
/superdesign explore 3 directions for a portfolio
/superdesign a hero illustration for an AI note-taking app

The anti-slop gate

# scan any built UI source for the machine-checkable AI tells
node templates/anti-slop-gate.mjs path/to/index.html

# WCAG contrast on the enumerated text/bg pairs
node templates/contrast-gate.mjs contrast-pairs.json

# full pre-flight on a surface vault (claims + anti-slop + contrast)
bash templates/preflight-gate.sh <vault-dir> path/to/index.html

A vault is the per-surface work dir (default .superdesign/<surface>/) holding claims.md and contrast-pairs.json; start both from templates/.

Per-line escape hatch: a line containing taste-ok suppresses the detector for a deliberate, justified choice (e.g. a neutral Inter read).

Install

git clone <superdesign-skill-repo> ~/skills/superdesign-skill
ln -s ~/skills/superdesign-skill ~/.claude/skills/superdesign

Then /superdesign <design intent> in Claude Code.

Test

bash tests/gate-scenarios.test.sh
bash tests/reference-links-contract.test.sh
bash tests/mode-routing-contract.test.sh
bash tests/asset-fallback-contract.test.sh

Credits

Builds on the sibling supergoal-skill (structure, contrast gate). Anti-slop rules adapt taste-skill (MIT); anti-pattern concepts distill impeccable (Apache-2.0, no code copied); asset/landing flow draws on stitch-landing-skill (MIT). Full attribution in reference/sources.md. License: MIT.

About

Master web/mobile designer as a Claude Code skill: intent-driven, trend-aware, anti-slop gated.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors