DonkeyKing01/tasteful-ui-skill / tasteful-ui
tasteful-ui
VerifiedUI design and implementation for real product surfaces with taste-first critique, reference routing, project-specific design briefs, variation comparison, and implementation verification. Use when Codex should redesign, build, polish, or critique frontend UI by reading project context, exploring taste, routing through `references/catalog.md`, synthesizing `PROJECT_DESIGN.md` or `design.md`, using investment gates to avoid wrong taste/reference/scope, implementing in the existing stack, and evaluating whether the result is actually better. Best for app screens, dashboards, landing pages, query tools, product surfaces, and design explorations; not for backend-only work or tiny cosmetic edits.
formats/PROJECT_DESIGN.template.md
View on GitHub# PROJECT_DESIGN
Use this format after project context, taste exploration, reference routing, and user confirmation.
The file should be specific enough for implementation without reopening every reference.
## 1. Product Context
- Product:
- Target user:
- Target surface:
- Primary job-to-be-done:
- Success criteria:
- Content/data that must appear:
- Interaction requirements:
- Technical constraints:
## 2. Existing UI Read
- Current visual vocabulary:
- Strongest existing cue to preserve:
- Components/tokens to reuse:
- Patterns to preserve:
- Patterns to evolve:
- Patterns to remove or avoid:
- Accessibility/state conventions already present:
## 3. Taste Direction
- Product identity sentence:
- Recommended taste direction:
- Direction to avoid:
- Why this makes the UI more useful:
- What should feel distinctive:
- What should stay quiet:
## 4. Selected References
For each selected reference:
- Why it fits:
- Transferable traits:
- Non-transferable brand details:
- Implementation substitutions:
- Risk:
- How to weaken or reject this reference if it hurts product fit:
## 5. Visual Theme & Atmosphere
- Design thesis:
- Emotional tone:
- Product personality:
- First viewport message:
- Visual weight priorities:
## 6. Color Palette & Roles
- Page/background:
- Primary surface:
- Secondary/elevated surface:
- Primary text:
- Secondary text:
- Muted text:
- Accent/CTA:
- Border/divider:
- Focus ring:
- Success/warning/error:
- Color constraints:
## 7. Typography Rules
- Font families and fallbacks:
- Display/hero:
- Section headings:
- Subheadings:
- Body:
- Labels/captions:
- Code/mono:
- Weight rules:
- Line-height rules:
- Letter-spacing rules:
## 8. Component Styling
Cover buttons, cards, containers, forms, navigation, lists, tables, empty/loading/error states, media, icons, and illustrations.
For each relevant component:
- Background:
- Border:
- Radius:
- Shadow/ring:
- Padding:
- Hover/focus/active/disabled:
- Mobile behavior:
## 9. Layout Principles
- Spacing scale:
- Container width:
- Grid:
- Section rhythm:
- Density model:
- Whitespace philosophy:
- Breakpoints:
- Mobile collapse strategy:
## 10. Depth, Motion, And Interaction
- Elevation levels:
- Border/ring/shadow rules:
- Motion personality:
- Transition rules:
- Touch target rules:
## 11. Do's And Don'ts
### Do
- ...
### Don't
- ...
## 12. Implementation Mapping
- Files likely to change:
- Existing components to reuse:
- Tokens/classes/variables to extend:
- New components needed:
- Assets needed:
- Data/copy assumptions:
## 13. Evaluation Plan
- Build/typecheck:
- Browser/screenshot:
- Responsive:
- Contrast/readability:
- Interaction states:
- Product fit:
- Reference alignment:
- Generic UI regression:
- Better-than-original check:
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |