mcpField
W
w-ui

w-ui

github.com/blockmaticDesign & UI1647 installsUpdated 4w ago
Repository

About w-ui

w-ui is a workflow skill for developers building or reshaping user-facing interfaces. It emphasizes using existing design conventions, handling relevant UI states, and checking the result on desktop and mobile.

Key features

  1. 01Define the surface and job
  2. 02Reuse shared components and design tokens
  3. 03Use mobile-first, keyboard-aware layouts
  4. 04Cover loading, empty, and error states
  5. 05Review desktop and mobile interactions

Use cases

  1. 01Build an interface feature for an app or docs
  2. 02Reshape a page within an existing design system
  3. 03Check interactions and responsive layouts

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/blockmatic/basilic-skills --skill w-ui

After installing, type/w-uiin Claude Code to confirm it loaded.

Details

From the project README

Build or reshape a user-facing surface. Planning a feature without UI work stays on /w-plan. Installing a primitive stays on /w-shadcn. Do not invent PRODUCT.md or DESIGN.md. Follow existing tokens and root DESIGN.md when present. Do not install animation libraries or design-detector hooks.

Load frontend-design for visual direction, composition-patterns for reusable APIs, and web-design-guidelines for the UI code checklist. Durable jobs live in matching MDX/README/DESIGN.md.

  1. Name the job, the person, and the surface mode: Operate (app/task), Persuade (marketing), or Read (docs).
  2. Use the brief, existing screens, or a stated aesthetic. If the repo has tokens and shared components, inspect those first.
  3. Prefer shared primitives. Compose at the second call site. Do not extract a compound API for a one-off route. Do not lift server data into a client provider.
  4. Mobile-first layout, visible focus, keyboard path, prefers-reduced-motion. Do not add a new motion library.
  5. Cover loading, empty, error, success, and overflow as applicable.
  6. Implement the smallest slice that completes the job.
  7. Inspect desktop and mobile together. Exercise primary interactions and keyboard navigation. Critique screenshots. Fix evidenced issues in one batch. Confirm with at most one more pass, then stop. If browser tools are missing, say so. A type check is not visual QA.
  8. Optional: /w-a11y against existing a11y docs and tests (do not invent a WCAG level). Playwright E2E only when an existing spec covers the path.
  9. Docs: /w-docs if behavior or commands changed.

Comments

Markdown supported