spec-kit-ui-design

Enforces design-system alignment and evidence requirements for UI work in Spec Kit projects.

Updated Jul 6, 2026
One-click install
npx skills add https://github.com/chenziyang110/launchdeck --skill spec-kit-ui-design-chenziyang110
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-kit-ui-design
Source: https://github.com/chenziyang110/launchdeck/tree/main/.claude/skills/spec-kit-ui-design
Command: npx skills add https://github.com/chenziyang110/launchdeck --skill spec-kit-ui-design-chenziyang110

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? UI implementation in Spec Kit projects often drifts into generic one-off styling that ignores the product's design system, and teams ship interface changes without visual or accessibility evidence. This Skill gates UI work against a committed DESIGN.md contract and requires platform-appropriate proof before closeout. ## Core Features & Use Cases - Design System Gate: Checks for DESIGN.md before substantive UI work and routes missing or thin design contracts to the sp-design workflow instead of inventing ad-hoc styling. - UI Reference Input Gate: Handles screenshots, Figma exports, mockups, and reference URLs through a ui-reference lane producing ui-brief.md and fidelity modes (approximate, high, inspiration). - Platform Rules & Evidence: Defines requirements for web, mobile, desktop, TUI, and CLI surfaces, including component state coverage and viewport screenshot evidence. - Use Case: When adding a new settings screen to a CLI tool, the Skill verifies DESIGN.md exists, requires a ui-brief.md for substantive changes, and demands terminal captures at narrow and normal widths before closeout. ## Quick Start Review this UI change against our DESIGN.md design system and tell me what evidence I need before closing out the task.

Frequently Asked Questions about spec-kit-ui-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep UI implementation aligned with a design system in Spec Kit?▼

Commit a DESIGN.md as the design contract and gate substantive UI work against it. Implementation must follow its layout, color, typography, and accessibility rules; if it is missing or too thin, run the sp-design workflow before coding.

What is a ui-brief.md and when do I need one?▼

A ui-brief.md is a feature-level UI contract required for substantive user-visible changes in Spec Kit projects. Narrow fixes following existing patterns may record a compact inline contract instead of a full brief.

Can I use screenshots or Figma exports as UI reference input?▼

Yes. Screenshots, Figma exports, HTML/CSS mockups, and reference URLs are treated as UI reference input and processed through the ui-reference-artifact lane, producing ui-reference-notes.md and a ui-brief.md with a chosen fidelity mode.

Does this design gate apply to CLI and TUI output?▼

Yes. TUI work must respect terminal widths, color fallback, and non-color indicators, while CLI work requires clear help text, stable output contracts, and accessible plain-text formatting, with terminal captures as evidence.

When can small UI changes skip the sp-design workflow?▼

Small changes may proceed without sp-design when existing design intent is clear and the change is a narrow component variant, copy adjustment, or low-risk CLI wording update. Record the soft risk and design assumption in the closeout.