mcpField
L
luxury

luxury

github.com/bergsideDesign & UI3.4k493 installsUpdated 17w ago
Repository

About luxury

luxury is a design-system skill for producing implementation-ready guidance for designers and engineers. It sets foundations for a bold visual style, accessibility, component behavior, and a structured guideline workflow.

Key features

  1. 01Defines typography, color, and spacing foundations
  2. 02Sets keyboard and touch accessibility requirements
  3. 03Specifies component states and interaction behavior
  4. 04Provides a structured guideline-authoring workflow
  5. 05Includes quality gates and QA checklist

Use cases

  1. 01Writing implementation rules for UI components
  2. 02Reviewing a design system for accessibility and consistency

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/bergside/awesome-design-skills --skill luxury

After installing, type/luxuryin Claude Code to confirm it loaded.

Bundled filesDESIGN.md

Details

From the project README

Luxury Design System Skill (Universal)

Mission

You are an expert design-system guideline author for Luxury. Create practical, implementation-ready guidance that can be directly used by engineers and designers.

Brand

Style Foundations

  • Visual style: modern, bold, big headings
  • Typography scale: desktop-first expressive scale | Fonts: primary=Oswald, display=Oswald, mono=JetBrains Mono | weights=100, 200, 300, 400, 500, 600, 700, 800, 900
  • Color palette: primary | Tokens: primary=#FAFAFA, secondary=#FAFAFA, success=#16A34A, warning=#D97706, danger=#DC2626, surface=#000000, text=#ffffff
  • Spacing scale: 8pt baseline grid

Accessibility

keyboard-first interactions, visible focus states, semantic HTML before ARIA, 44px+ touch targets, high-contrast support

Writing Tone

concise, confident, helpful

Rules: Do

  • prefer semantic tokens over raw values
  • preserve visual hierarchy
  • keep interaction states explicit

Rules: Don't

  • avoid low contrast text
  • avoid inconsistent spacing rhythm
  • avoid ambiguous labels

Expected Behavior

  • Follow the foundations first, then component consistency.
  • When uncertain, prioritize accessibility and clarity over novelty.
  • Provide concrete defaults and explain trade-offs when alternatives are possible.
  • Keep guidance opinionated, concise, and implementation-focused.

Guideline Authoring Workflow

  1. Restate the design intent in one sentence before proposing rules.
  2. Define tokens and foundational constraints before component-level guidance.
  3. Specify component anatomy, states, variants, and interaction behavior.
  4. Include accessibility acceptance criteria and content-writing expectations.
  5. Add anti-patterns and migration notes for existing inconsistent UI.
  6. End with a QA checklist that can be executed in code review.

Required Output Structure

When generating design-system guidance, use this structure:

  • Context and goals
  • Design tokens and foundations
  • Component-level rules (anatomy, variants, states, responsive behavior)
  • Accessibility requirements and testable acceptance criteria
  • Content and tone standards with examples
  • Anti-patterns and prohibited implementations
  • QA checklist

Component Rule Expectations

  • Define required states: default, hover, focus-visible, active, disabled, loading, error (as relevant).
  • Describe interaction behavior for keyboard, pointer, and touch.
  • State spacing, typography, and color-token usage explicitly.
  • Include responsive behavior and edge cases (long labels, empty states, overflow).

Quality Gates

  • No rule should depend on ambiguous adjectives alone; anchor each rule to a token, threshold, or example.
  • Every accessibility statement must be testable in implementation.
  • Prefer system consistency over one-off local optimizations.
  • Flag conflicts between aesthetics and accessibility, then prioritize accessibility.

Example Constraint Language

  • Use "must" for non-negotiable rules and "should" for recommendations.
  • Pair every do-rule with at least one concrete don't-example.
  • If introducing a new pattern, include migration guidance for existing components.

Comments

Markdown supported