design-philosophy

Guides VS Code UI design decisions using a Values, Principles, and Moves vocabulary.

Updated Aug 30, 2026
One-click install
npx skills add https://github.com/Tyrizx/Tyrizx --skill design-philosophy-tyrizx
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-philosophy
Source: https://github.com/Tyrizx/Tyrizx/tree/main/.github/skills/design-philosophy
Command: npx skills add https://github.com/Tyrizx/Tyrizx --skill design-philosophy-tyrizx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? UI feedback often stalls at vague pixel-level complaints like "make this 6px" or "this feels off," which fixes one spot while the underlying design rule stays broken everywhere else. This Skill provides a shared design vocabulary so designers, engineers, and agents can reason about VS Code interfaces in terms of values and principles rather than raw pixels. ## Core Features & Use Cases - Values-Principles-Moves framework: Diagnose any UI issue by naming the feeling (Calm, Focused, Consistent, Delightful), the principle it breaks, and the concrete move that fixes it. - Design token decision rules: Apply elevation tiers (4/6/8px radii), the spacing ramp, type roles with two weights, 16/12px icon sizes, one-stroke borders, and theme colors with explicit rules for which value to choose and why. - Feedback phrasebook: Translate pixel-level complaints into principled statements, with worked examples for busy panels, flat settings rows, mismatched dialogs, and gimmicky animations. - Use Case: When reviewing a screenshot of a noisy side panel, identify that it breaks "Quiet at rest," then prescribe dropping it to a recessed background token and demoting labels to a quieter type role. ## Quick Start Ask the design philosophy skill to review this UI screenshot and explain which design principles it violates and how to fix them.

Frequently Asked Questions about design-philosophy

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

FAQPage Schema
How do I give actionable UI design feedback in VS Code?▼

Lead with the feeling (Calm, Focused, Consistent, or Delightful), name the surface, state the principle it breaks, then suggest the move that fixes it. Only mention pixel numbers last, since naming the rule fixes the issue everywhere rather than in one spot.

What corner radius should I use for VS Code UI surfaces?▼

Radius is chosen by elevation tier, not taste: 4px for controls like buttons and inputs, 6px for inner containers, and 8px for floating overlays like menus and dialogs. Pick the tier by the surface's role in the stack.

What icon sizes does VS Code support for codicons?▼

Codicons come in exactly two sizes: 16px base for standalone or primary actions, and 12px compact for dense rows and inline glyphs. At compact size, also swap to the matching Compact glyph variant; 14px is always a bug.

Can I use font-weight 500 in VS Code UI text?▼

No, the type ramp allows only two weights: regular (400) and semiBold (600). A 500 anywhere is off the ramp and should snap to semiBold; emphasis comes from the same role token at semiBold, not a bigger size.

Should VS Code UI labels use sentence case or title case?▼

The design philosophy prefers sentence case for calmer, more readable labels, but it conflicts with the repo-wide guideline mandating title case. Until reconciled, follow title case for shipped non-experimental UI and sentence case only in surfaces adopting the modern UI direction.

When is animation appropriate in VS Code interfaces?▼

Motion must do a job: guide the eye, confirm an action, orient the user, or smooth a jump. Keep it subtle, short, and interruptible, honor prefers-reduced-motion, and cut any transition that is purely decorative.