design-system-rules

Define design tokens, typography scales, color palettes, and composition grammar for visual systems.

1|Updated Jun 29, 2026
One-click install
npx skills add https://github.com/coreyone/software-maestro --skill design-system-rules-coreyone
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-system-rules
Source: https://github.com/coreyone/software-maestro/tree/main/design/systems-and-foundations/design-system-rules
Command: npx skills add https://github.com/coreyone/software-maestro --skill design-system-rules-coreyone

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams building interfaces often ship inconsistent visuals, generic AI-generated aesthetics, and undocumented design decisions that drift across components. This Skill provides a structured audit checklist and rule set for defining design tokens, visual hierarchy, composition grammar, and anti-pattern detection so interfaces stay coherent and reproducible. ## Core Features & Use Cases - Token & Foundation Definition: Establish semantic color, typography, spacing, elevation, motion, and radius tokens with light/dark mode mapping and governance rules. - Anti-Pattern Detection: Identify generated-UI tells such as gradient text, nested cards, AI violet palettes, side-tab borders, and flat type hierarchies with concrete acceptance criteria. - AI-Recreation Resilience: Produce identity statements, asset taxonomies, composition grammar, and failure-mode tables so an AI can recreate an interface from screenshots without drift. - Use Case: When auditing a landing page that looks generic, run this Skill to flag violations like hero eyebrow chips, oversized headlines, and hardcoded hex colors, then output a token-based remediation plan. ## Quick Start Audit this interface's design system and define semantic color, typography, and spacing tokens with light and dark mode support.

Frequently Asked Questions about design-system-rules

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

FAQPage Schema
How do I define design tokens for light and dark modes?▼

Define semantic token roles such as surface, ink, and elevation, then map each role to light and dark values instead of hardcoding hex colors in components. The Skill's checklist covers naming conventions, contrast pairs, and implementation-ready formats like CSS variables or JSON.

What are common AI-generated UI design anti-patterns?▼

Common tells include violet/cyan palettes, gradient-clipped text, nested cards, hero eyebrow chips, oversized headlines, hairline borders with wide shadows, and decorative grid backgrounds. The Skill catalogs these with measurable thresholds and remediation guidance for each.

How do I audit a design system for visual consistency?▼

Use the audit checklist in references/source.md covering principles, tokens, visual language, composition grammar, component contracts, motion, and responsive behavior. Validate findings with screenshots, computed styles, and accessibility checks, then record decisions in a Before/After table.

When should I not use this design system skill?▼

Do not use it as the primary guide for backend architecture, threat modeling, release operations, or framework-specific implementation tasks. It is scoped to design-system definition, UX architecture, visual hierarchy, and screenshot-based visual QA.

How do I make an interface reproducible by AI from screenshots?▼

Provide an identity sentence, asset taxonomy with approved sources, illustration and composition grammar, responsive art direction rules, and a failure-mode table with acceptance checks. Include a prompt-ready handoff block with negative constraints, not just positive adjectives.