design-system-foundations

Derive a semantic token taxonomy and scale structure from a named aesthetic direction.

15|5|Updated May 4, 2026
One-click install
npx skills add https://github.com/eugenelim/agent-ready-repo --skill design-system-foundations-eugenelim
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-system-foundations
Source: https://github.com/eugenelim/agent-ready-repo/tree/main/packs/design-craft/.apm/skills/design-system-foundations
Command: npx skills add https://github.com/eugenelim/agent-ready-repo --skill design-system-foundations-eugenelim

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps teams convert a named aesthetic direction into a coherent design-system foundation, so token names, scales, and composition rules stay consistent as the product grows.

Core Features & Use Cases

  • Semantic token taxonomy: Defines tokens by role instead of appearance, which makes future visual changes easier without renaming everything.
  • Ratio-based scales: Organizes spacing and type around one conceptual ratio, keeping the system explainable and internally consistent.
  • Atomic composition: Builds from primitive tokens to reusable components and then pages, preventing one-off screen-level decisions from fragmenting the system.
  • Accessibility floor: Bakes accessibility constraints into derivation instead of treating them as a later cleanup pass.
  • Use case: A product team with a clear brand direction can use this Skill to establish the foundational token structure for a component library before implementation begins.

Quick Start

Use the design-system-foundations skill to derive a semantic token taxonomy and symbolic scale structure from the team's named aesthetic direction.

Frequently Asked Questions about design-system-foundations

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

FAQPage Schema
How do I set up a design token taxonomy from an existing brand aesthetic?

To set up a design token taxonomy from a brand aesthetic, derive semantic role-based names from the aesthetic direction, ensuring visual changes can occur without renaming tokens. This approach preserves semantic-over-literal naming and structures scales using ratio-based symbolic steps.

Can I generate a spacing and type scale that meets accessibility requirements?

Yes, you can generate accessible spacing and type scales because accessibility constraints act as a derivation-time floor. Baking accessibility into the foundational token derivation prevents non-compliant contrast or sizing ratios from entering the component library, avoiding later cleanup passes.

Does this design token approach support W3C Design Tokens serialization?

This token derivation approach supports W3C Design Tokens serialization, ensuring the generated semantic taxonomy and scale structure align with standard formats. This allows the foundational tokens to integrate smoothly with standard-compliant design system tools and pipelines.

What is the best way to structure design system tokens for atomic composition?

The best way to structure design system tokens for atomic composition is building from primitive tokens to reusable components and then pages. This prevents one-off screen-level decisions from fragmenting the design system and maintains foundational consistency.