mcpField
I
interface-design-taste

interface-design-taste

github.com/jpcaparasDesign & UI56115 installsUpdated 1d ago
Repository

About interface-design-taste

A design skill for shaping and reviewing product interfaces across web and desktop. It combines decision guides, reference material, and reusable templates for hierarchy, interaction, accessibility, and platform fit.

Key features

  1. 01Design direction and style exploration
  2. 02Interface critique workflow
  3. 03Layout, type, color, and motion guidance
  4. 04Platform-specific adaptation
  5. 05Design tokens and component rules

Use cases

  1. 01Develop a visual direction for a new product
  2. 02Prioritize fixes for an existing interface
  3. 03Adapt an interface across web and desktop
  4. 04Capture reusable design-system guidance

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/jpcaparas/skills --skill interface-design-taste

After installing, type/interface-design-tastein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

AGENTS.md
metadata.json
README.md
skill-card.prompt.md
agents/
openai.yaml
assets/
.gitkeep
evals/
evals.json
references/
color-material-and-iconography.md
critique-workflow.md
design-systems-and-tokens.md
gotchas.md
interaction-motion-and-states.md
layout-and-rhythm.md
platform-adaptation.md
principles.md
README.md
style-families.md
typography-and-copy.md
scripts/
test_skill.py
validate.py
templates/
critique-scorecard.md
design-brief-template.md

Details

From the project README

interface-design-taste

Build interfaces that feel deliberate, product-appropriate, and structurally clear instead of generic, noisy, or under-designed.

Decision Tree

What kind of design problem are you solving?

  • Need a direction from scratch for a site, app, or desktop product

    • Use references/principles.md if the brief needs grounding
    • Use references/style-families.md if examples would help explore a direction
  • Need to improve an existing interface without rewriting everything blindly

    • Read references/critique-workflow.md
    • Then branch into the weakest layer: layout, typography, color, motion, or platform fit
  • Need stronger hierarchy, composition, spacing, or screen structure

    • Read references/layout-and-rhythm.md
  • Need better type choices, copy tone, labels, or information cadence

    • Read references/typography-and-copy.md
  • Need a tighter palette, clearer surfaces, better icons, or more intentional imagery

    • Read references/color-material-and-iconography.md
  • Need hover/focus/active states, transitions, onboarding flow polish, or motion guidance

    • Read references/interaction-motion-and-states.md
  • Need platform-specific guidance for marketing web, product web, or desktop UI

    • Read references/platform-adaptation.md
  • Need to turn the design direction into reusable tokens and component rules

    • Read references/design-systems-and-tokens.md
    • Use templates/design-brief-template.md
  • Need traps, failure modes, or "why does this still feel off?" answers

    • Read references/gotchas.md

Quick Reference

NeedReadOutcome
Turn a vague prompt into a design directionreferences/principles.mdclear priorities and useful planning dimensions
Explore visual approaches without copying a trendreferences/style-families.mdadaptable examples, including coherent combinations
Fix hierarchy and compositionreferences/layout-and-rhythm.mdstronger screen structure and spacing logic
Fix type, labels, and tonereferences/typography-and-copy.mdcleaner hierarchy and more credible copy
Fix palette, surfaces, icons, or imageryreferences/color-material-and-iconography.mdintentional visual relationships and readable contrast
Fix motion and all UI statesreferences/interaction-motion-and-states.mdpurposeful transitions and complete interaction design
Adapt the same idea to site, app, or desktopreferences/platform-adaptation.mdplatform-appropriate behavior and density
Audit an existing screen or flowreferences/critique-workflow.mdprioritized redesign sequence
Capture the result as a reusable systemreferences/design-systems-and-tokens.mdtokens, component rules, and handoff structure

Default Workflow

  1. Identify the artifact, user task, and requested character: marketing page, content page, product surface, dashboard, or desktop tool.
  2. Use the taste axes or relevant references when they clarify a decision; skip a worksheet when the brief already supplies direction.
  3. Develop a coherent composition. Mixing styles, expressive motion, and one-off flourishes can serve the brief; connect them through hierarchy, rhythm, or another deliberate relationship.
  4. Check hierarchy, interaction states, accessibility, and platform fit alongside expression. Preserve the user's intent rather than substituting a house style.
  5. Capture reusable tokens and component rules when reuse, handoff, or design-system work calls for them, not for every one-off screen.

Taste Axes

These optional dimensions can make vague "make it nicer" requests more concrete. Use whichever help; they are neither a required worksheet nor a fixed style menu.

AxisLow EndHigh EndWhat It Controls
Composurerestrainedtheatricalhow loudly the interface performs
Densityspaciousoperationalhow much work fits into a screen
Contrastsoftsharpedge definition, hierarchy, and tension
Materialityflatlayeredborders, shadows, blur, and surface depth
Motionstillexpressivemovement for feedback, narrative, atmosphere, or delight

Use the axes as discussion aids, not scores to optimize. A dense desktop tool can still be calm or playful. A marketing page can still be restrained.

Operating Rules

  1. Fit the product before fitting a trend. The right answer for a workflow tool is not the same as the right answer for a launch page.
  2. Establish hierarchy at three distances: page structure, section structure, and component structure.
  3. Treat states as part of the design, not implementation leftovers. Empty, loading, success, error, hover, focus, and selected states all count.
  4. Motion may clarify change or add expression and delight. Keep controls responsive, respect reduced-motion preferences, and avoid flashing or movement that makes content unsafe or hard to use.
  5. Use repetition where it helps recognition; allow deliberate exceptions and decoration where they add meaning or character without obscuring tasks.
  6. Prefer specific, believable copy and realistic data over placeholder language.
  7. Preserve readable contrast, keyboard access, visible focus, and understandable labels across styles. Do not rely on color alone for essential meaning.

Platform Guardrails

  • Marketing web:

    • Allow more dramatic pacing and asymmetry.
    • Let imagery and motion carry more narrative weight.
  • Product web:

    • Favor navigational clarity, repeated tasks, and fast scanability.
    • Expressive styling and motion can fit; keep essential feedback recognizable and repeated tasks unblocked.
  • Desktop:

    • Design for density, keyboard use, secondary controls, and longer sessions.
    • Adapt promotional gestures so they do not displace working space or precision controls.

Use references/platform-adaptation.md when translating a visual language between these contexts.

Review Questions

Use the questions relevant to the task before finalizing. The two-second glance and 20% removal are diagnostic heuristics, not timing gates or reduction quotas; dense reference tools and expressive experiences may need different checks.

  1. What is the first thing the user should notice in under two seconds?
  2. What would disappear if you removed 20% of the chrome?
  3. Which states are still undesigned?
  4. Does the interface feel like the product category, or like a generic AI demo?
  5. Would this still hold up with real content, messy data, and long labels?

Gotchas

  1. A beautiful hero does not rescue a weak working surface.
  2. Extra shadows do not create hierarchy if the grouping is wrong.
  3. Unclear color roles can create competition; a rich palette can work when hierarchy and contrast remain readable.
  4. Dense interfaces fail from rhythm problems more often than from lack of whitespace.
  5. Desktop tools need affordances for precision, not just prettier cards.
  6. Decorative motion cannot substitute for missing interaction feedback, even when theater is part of the brief.
  7. A design system created too early can freeze a bad direction into reusable parts.

Keeping Guidance Useful

Start with stable principles: hierarchy, legibility, task fit, accessible interaction, and coherent expression. If this guidance is insufficient or conflicts with observed behavior, consult current official platform/tool or accessibility documentation, or trusted design research for the specific question; routine design work does not require browsing. Propose a sourced correction to the canonical skill with a concrete example or check. Do not silently mutate installed copies.

Reading Guide

If the task is...Read
"Give this project a stronger visual direction"references/principles.md for grounding or references/style-families.md for examples, as needed
"This screen feels flat and generic"references/layout-and-rhythm.md and references/color-material-and-iconography.md
"The hierarchy is off and the copy feels weak"references/typography-and-copy.md
"The interactions are clumsy or unfinished"references/interaction-motion-and-states.md
"Make this work as both web and desktop"references/platform-adaptation.md
"Audit what exists and tell me what to fix first"references/critique-workflow.md
"Turn this into a reusable component system"references/design-systems-and-tokens.md plus templates/design-brief-template.md
"Why does this still feel cheap?"references/gotchas.md

Helper Files

  • references/README.md — reference index and routing overview
  • templates/design-brief-template.md — reusable brief for new work
  • templates/critique-scorecard.md — audit and redesign worksheet
  • scripts/validate.py — structural validator for this skill
  • scripts/test_skill.py — packaging and content coverage checks

Comments

Markdown supported