ui-design-system

Create and govern design systems with semantic tokens, accessible components, and migration guidance.

1|Updated Aug 7, 2025
One-click install
npx skills add https://github.com/zzafergok/arktos --skill ui-design-system-zzafergok
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ui-design-system
Source: https://github.com/zzafergok/arktos/tree/main/.agent/skills/ui-design-system
Command: npx skills add https://github.com/zzafergok/arktos --skill ui-design-system-zzafergok

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams building multiple interfaces often repeat visual decisions and drift into inconsistent components, tokens, and accessibility behavior. This Skill structures the creation, evolution, and documentation of a shared design system so product surfaces stay coherent. ## Core Features & Use Cases - Token Architecture: Defines layered primitive, semantic, and component tokens with theming via semantic role remapping and explicit contrast requirements. - Component Contracts: Specifies purpose, anatomy, variants, states, keyboard and assistive-technology behavior, and API defaults for each shared component. - Governance & Migration: Treats token and API changes as compatibility-sensitive, documents breaking changes, and plans incremental migration paths. - Use Case: When three product teams each maintain their own button styles, use this Skill to inventory the duplication, define a semantic token layer, and publish a single accessible button contract with a migration plan. ## Quick Start Audit our existing UI components and propose a semantic token architecture and component contract for a shared design system.

Frequently Asked Questions about ui-design-system

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

FAQPage Schema
How do I create a design system for multiple products?▼

Start by inventorying existing tokens, components, and duplicated patterns across products. Then define layered tokens (primitive, semantic, component), write component contracts covering variants and accessibility behavior, and establish governance for breaking changes.

How to structure design tokens for theming support?▼

Use three layers: primitive values like palette steps and spacing, semantic roles like surface and text-muted, and component tokens only for stable decisions. Support themes by remapping semantic roles rather than duplicating component styles.

When should I build a design system versus a single component?▼

Build a design system when multiple interfaces need shared visual and interaction rules. For a single isolated component, only escalate to system-level work if it exposes a genuine gap in shared tokens or patterns.

How do I migrate consumers when design tokens change?▼

Treat shared token and component API changes as compatibility-sensitive. Document breaking changes, provide an incremental migration path, measure adoption, and remove obsolete paths only after consumers have migrated.

What accessibility requirements should design system components define?▼

Each component contract should specify keyboard behavior, assistive-technology interaction, interactive and validation states, and contrast requirements for tokens. Validate components visually, behaviorally, and with accessibility checks before release.