shadcn/ui composition

SkillDocs & knowledge

Map product UI onto the canvas with shadcn-like grammar, roles, tokens, and patterns (not React trees).

Then ask your AI: use the shadcn/ui composition skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add it as a step in a pipeline you build on Ahel, or connect Ahel to Claude, ChatGPT, Cursor, Claude Code or Codex and ask your AI to use it.

About this skill

zuoge, open-source AI design workspace with a document-derived SoA infinite artboard and Design Agent

What this skill tells your AI

The instructions your AI receives, as published by recombyn/zuoge in .agents/skills/shadcn_ui/SKILL.md and read by Ahel’s review.

Map product UI onto the canvas with shadcn-like grammar — roles, tokens, and patterns (not React trees).

Principles

  1. Roles, not one-off skins — primary / secondary / ghost / destructive mean the same everywhere.
  2. Semantic color — background / foreground / primary / muted / danger — not random hex.
  3. One radius + spacing rhythm across the board.
  4. Labeled states — never color alone for active/error/disabled.
  5. Compose from patterns — invent chrome only if nothing fits.

Workflow

  1. Name the screen job (settings, dashboard, form, dialog, marketing section …).
  2. Pull tokens from awesome_design_md if available.
  3. Compose from the pattern table; keep heights aligned within a control family.
  4. Verify labels, errors, and primary action.

Patterns

NeedCompose
Button primaryFilled primary + centered label; loading = visible state
Button secondary/ghostStroke or muted fill + label; same height as primary
DestructiveDanger fill/stroke + clear label
InputLabel above; field; optional placeholder; error adjacent
Form groupRelated fields stacked with shared left edge
CardSurface + title + body + optional action row
TableHeader row + aligned columns; no clipped cells
NavTop or side; active = weight and color
TabsLabel row; active underline; panel below
Dialog / drawerPanel with title + body + actions
Toast / alertCompact surface + short message
Badge / avatarSmall pill or circle + short text/initials
SkeletonMuted bars matching content layout
Switch / checkboxAffordances labeled by adjacent text

Density notes

ContextLean
SettingsComfortable field spacing; clear section titles
DashboardTighter tables OK; keep header distinct
Marketing embedFewer controls; one primary CTA

Do not

  • Stack fields with only spacing and no labels
  • Open dialog/drawer without a title
  • Rely on color alone for state
  • Mix Material festive icons into product UI chrome
  • Emit React/JSX

Related

dashboard_ui / mobile_app_ui / landing_page; awesome_design_md for brand tokens.

Done when

Hierarchy reads in one glance; interactive states are labeled; spacing rhythm is consistent; primary action is obvious.

Signals

GitHub stars
55
Forks
9
Last commit
Sep 2026
Advanced
Item type
skill
Key
shadcn-ui-recombyn
Source
github.com/recombyn/zuoge