Skip to content

Latest commit

 

History

12 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

UX/UI Design Taste

Senior product design judgment for AI-assisted frontend work.

MIT License design-taste skill Claude, Cursor, Copilot, Codex

design-taste is an AI agent skill that makes generated interfaces feel intentional: clearer hierarchy, stronger spacing, better typography, more restrained color, realistic content, accessible interaction states, and fewer generic template tells.

This skill is the result of hands-on research into what actually works and what doesn't when giving AI agents design judgment. Not theoretical guidelines — principles battle-tested through real projects and iteration on AI-generated output. The patterns here are the ones that consistently move output from "looks AI-generated" to "looks considered."

It is framework-agnostic. Use it with React, Next.js, HTML/CSS, Framer code components, shadcn/ui, or any frontend surface where visual quality matters.


Install

Claude Code (primary)

Copy the skill into your project's .claude/skills/ directory:

cp -r skills/design-taste path/to/your-project/.claude/skills/

Then reference it in prompts:

Use $design-taste to review and improve this component.

Or inject directly into your project's CLAUDE.md by copying the contents of skills/design-taste/SKILL.md.

Cursor

Copy the Cursor rule to your project:

cp -r .cursor path/to/your-project/

The rule in .cursor/rules/design-taste.mdc will activate automatically when working on frontend files (*.tsx, *.jsx, *.css, *.html, *.vue, *.svelte). You can also invoke it by mentioning design work in your prompt.

GitHub Copilot

Copy the Copilot instructions to your project:

cp .github/copilot-instructions.md path/to/your-project/.github/

GitHub Copilot reads .github/copilot-instructions.md automatically. This gives Copilot the design judgment layer for all frontend work in your project.

OpenAI Codex

Install via the Codex CLI:

npx skills add https://github.com/arez-xd/ux-ui-design-taste --skill design-taste

Or copy the skill folder directly:

skills/design-taste/

Use Cases

Use design-taste when you want an AI coding agent to:

  • Build a new frontend interface with stronger visual judgment.
  • Review an existing UI and identify design issues before editing.
  • Improve hierarchy, spacing, typography, color, and component polish.
  • Redesign dashboards, data views, forms, navigation, modals, cards, and empty states.
  • Add motion that feels intentional and remains performant.
  • Avoid generic AI-generated SaaS layouts and placeholder content.

Example Prompts

Claude Code

Use $design-taste to redesign this dashboard so it feels sharper and less generic.
Use $design-taste to review this React component, then implement the polish pass.
Use $design-taste — focus on accessibility, responsive behavior, and realistic content.

Cursor

Apply design-taste principles to this component. Focus on hierarchy and spacing.
Review this page for design issues using design-taste, then fix the most impactful ones.

GitHub Copilot

With .github/copilot-instructions.md installed, design principles apply automatically. You can also be explicit:

Apply senior designer judgment here. Prioritize visual hierarchy and restraint.

OpenAI Codex

Use $design-taste to refine this interface and make it feel intentional.

Skill Structure

skills/design-taste/
|-- SKILL.md                          # Core design judgment layer (source of truth)
|-- agents/
|   |-- claude.yaml                   # Claude agent config
|   `-- openai.yaml                   # Codex agent config
`-- references/
    |-- accessibility-review.md
    |-- component-taste.md
    |-- content-realism.md
    |-- frontend-guardrails.md
    |-- motion-performance.md
    |-- motion-taste.md
    |-- polish-review.md
    |-- redesign-audit.md
    |-- shadcn-implementation.md
    `-- visual-dials.md

Adapter files (generated from SKILL.md, keep in sync when updating):

CLAUDE.md                             # Claude Code repo context
.cursor/rules/design-taste.mdc        # Cursor rule (full content inline)
.github/copilot-instructions.md       # Copilot instructions (full content inline)

SKILL.md is the source of truth. The adapter files embed the core content so Cursor and Copilot can use it without dynamic file loading. The references/ files are loaded only when the task calls for them.


What It Optimizes For

  • One clear focal point per view.
  • Spacing as structure, not leftover padding.
  • Color that communicates function and hierarchy.
  • Typography that creates scannable information architecture.
  • Restraint over decoration.
  • Existing design-system alignment before new styling.
  • Interaction states, responsiveness, accessibility, and final polish.

References

The skill routes deeper guidance by task type:

  • component-taste.md — cards, tables, forms, dashboards, navigation, buttons, badges, toasts, empty states
  • motion-taste.md and motion-performance.md — animation feel and performance guardrails
  • accessibility-review.md — forms, dialogs, menus, keyboard behavior, screen reader output
  • redesign-audit.md — improving existing UI rather than building from scratch
  • content-realism.md — believable example data and product copy
  • frontend-guardrails.md — React, Next.js, Tailwind, responsive layout mechanics
  • shadcn-implementation.md — shadcn/ui, Radix/Base UI, Tailwind variants
  • visual-dials.md — calibrating visual direction (stronger/weaker, denser/airier)
  • polish-review.md — final quality pass, pre-ship review, expanded anti-patterns

Common Questions

Is this a component library? No. It is an agent skill: reusable instructions and references that improve how an AI agent designs and implements UI.

Does it require a specific framework? No. The principles apply across frontend stacks. Framework-specific guidance is loaded only when useful.

Does it work with all AI coding tools? Yes. Claude Code is the primary target. Cursor, GitHub Copilot, and OpenAI Codex are all supported via their respective adapter files.

Why does the skill have separate files for Cursor and Copilot? Those tools can't dynamically load files from references/ the way Claude Code can. The adapter files embed the core content inline so the agent has immediate access to the design judgment layer without extra setup.

Can it be used for UI review only? Yes. Ask the agent to use $design-taste (or reference design-taste principles) for a review pass before implementation.

Why split references out of SKILL.md? Progressive disclosure. The agent reads the core rules first, then loads only the targeted reference files needed for the current task. Keeps the main context focused.


License

MIT (c) 2026 Adam Reznik

About

Product designer judgment for AI coding agents. Works with Claude Code, Cursor, and Codex. Battle-tested principles that separate intentional UI from generated slop.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages