ClaudeMap

suzhe-ui

A Claude Skill that teaches the web design method behind suzhe.ai — an Apple-grade restrained skeleton, one signature visual per page, two strict registers (commerce vs editorial), and 16 documented rejected redesigns

Skills & Commandsskillweb designuidesign systemfrontend

suzhe-ui is a Claude Skill (version 1.0.0) that installs the design method behind suzhe.ai so that every page Claude builds or redesigns follows it. The method starts from page type and register: brand and shop pages speak the commerce register (three backgrounds only — white, #f5f5f7, black — alternating so adjacent sections never match; system fonts; one accent, #0071e3; pill buttons; third-party brand colors as accents, never full-bleed fills), while sign-in, about pages and share cards are identity moments in the editorial register (warm paper #faf9f5 or warm black #141413, one serif statement, ink buttons instead of blue, thin borders, no heavy shadows); formal pages and tools have their own rules — one page, one register. Eight rules total, adding: every page gets one signature visual belonging to this product and task, hide what is unavailable, help text is one sentence, hints appear only after the user actually missed something, motion marks state changes, heavy effects degrade by device tier, and comfortable pages are improved incrementally rather than rebuilt. The skill ships the method plus ready-to-copy material: tokens.css for both registers, component and page-type references, motion/performance rules, a pre-ship checklist, assets/starter.html, and runnable evals (claude plugin eval). rejected.md documents 16 rejected redesign attempts and why each failed. READMEs in English, Simplified Chinese, Japanese and Korean, with a full Chinese edition of the skill in docs/zh-CN. Apache-2.0, with the Suzhe AI name and logo excluded per NOTICE.

What it does

  • Register-first method: classify the page (commerce / editorial / formal / tool) before writing any CSS — one page, one register
  • Concrete tokens, not vibes: commerce = white / #f5f5f7 / black backgrounds, #0071e3 accent, pill buttons; editorial = #faf9f5 or #141413, serif statement, ink buttons
  • Signature rule: one visual per page that belongs to this product and this task, never a copy of someone else's homepage
  • rejected.md carries 16 real rejected redesigns with failure reasons — the negative space of the method, not just the rules
  • Ships as material, not prose: tokens.css, components.md, page-types.md, motion-perf.md, checklist.md, starter.html and runnable evals via claude plugin eval
  • Install three ways: Claude Code plugin marketplace, manual copy into ~/.claude/skills/ (or a project's .claude/skills/), or a claude.ai skill upload from the release ZIP

When to use it

Use when Claude-built pages drift into generic AI-slop styling — landing pages, sign-in flows and share cards that should carry one coherent, restrained house style — or when you want a worked example of encoding a real site's design decisions (including its rejected alternatives) into a reusable skill.

Getting started

Claude Code as a plugin:

/plugin marketplace add suzhe-ai/suzhe-ui
/plugin install suzhe-ui@suzhe-ui

Claude Code manual copy:

git clone https://github.com/suzhe-ai/suzhe-ui.git
cp -r suzhe-ui/skills/suzhe-ui ~/.claude/skills/

For one project only, copy to your-project/.claude/skills/ instead. claude.ai: download suzhe-ui.zip from the latest release page, then Customize -> Skills -> + -> Upload a skill. There is nothing to call afterwards — just ask for the page you want, or say Use suzhe-ui explicitly.

Things to know

This is one site's house style, deliberately opinionated: it imposes suzhe.ai's restrained Apple-adjacent aesthetic rather than offering a neutral design system, so pages you wanted bold or playful will come out restrained — treat it as a strong default you opt into, not a general-purpose design assistant. The skill text is English with a full Chinese edition in docs/zh-CN; the repo additionally has Japanese and Korean READMEs. Legal edge: the Apache-2.0 license excludes the Suzhe AI name and logo per NOTICE, so derivative skills should rebrand. Version 1.0.0 at writing; the compare screenshot is the README's own demonstration. Apache-2.0 license. 15 stars as of writing (2026-11-16).

Repository

suzhe-ai/suzhe-ui

Charted

Related on the map

  • An instruction-only skill that makes agents research before they ask, plan before they build, and verify before they call anything done.

    • workflow
    • verification
    • quality
    • skill
  • Guizang's agent skill turns your repo's recent updates into a finished promo video — real components, code-rendered animation, an original code-written soundtrack — no video editor involved.

    • agent-skill
    • video
    • promo
    • marketing
  • An agent skill that geolocates a photo with nothing readable in it — OSM geometry, elevation skylines and satellite tiles turn “where was this taken?” into a measured answer with an error radius.

    • agent-skill
    • geolocation
    • osint
    • openstreetmap