design-system

Detect hard-coded values and generate design system component structures.

14|1|Updated Dec 5, 2025
One-click install
npx skills add https://github.com/jpoutrin/product-forge --skill design-system-jpoutrin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-system
Source: https://github.com/jpoutrin/product-forge/tree/main/plugins/product-design/skills/design-system
Command: npx skills add https://github.com/jpoutrin/product-forge --skill design-system-jpoutrin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solves?

Maintaining UI consistency, promoting component reuse, and managing design tokens across multiple projects can be challenging without a well-structured design system. This Skill automates the application and management of design system principles.

Core Features & Use Cases

  • Identify Opportunities: Automatically detects when code could benefit from design system patterns (e.g., repeated styles, similar components, magic numbers).
  • Design Token Architecture: Guidance on structuring design tokens into primitive, semantic, and component-specific layers.
  • Component Structure: Recommendations for organizing UI components using Atomic Design principles (atoms, molecules, organisms, templates).
  • Component File Structure: Standardized file organization for individual components, including implementation, styles, types, tests, and Storybook documentation.
  • Warning Triggers: Automatically warns about hard-coded values, duplicate styles, missing documentation, and inconsistent naming.
  • Use Case: Creating a new UI component for a design system, extracting hard-coded styles into design tokens, auditing an existing component library for consistency, or documenting component usage in Storybook.

Quick Start

Use the design-system skill to generate a file structure for a new 'Button' atomic component, including Button.tsx, Button.styles.ts, and Button.stories.tsx.

Frequently Asked Questions about design-system

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

FAQPage Schema
How do I maintain UI consistency across multiple projects without a design system?▼

A design system centralizes UI components, tokens, and patterns into a reusable framework. It ensures consistency, reduces duplication, and enables component reuse across applications through automated checks and documentation.

How do I structure design tokens into layers?▼

Design tokens organize into three layers: primitives (base colors, spacing), semantic tokens (meaningful abstractions), and component-specific tokens. This architecture ensures scalability and enables consistent theming across your UI.

What's the best way to organize UI components using Atomic Design?▼

Atomic Design organizes components into atoms (basic elements), molecules (simple combinations), organisms (complex groups), and templates (page layouts). This structure promotes reusability and clarity in component libraries.

How do I detect hard-coded values and duplicate styles in my component library?▼

Automated checks identify hard-coded values, repeated styles, missing documentation, and inconsistent naming across components. These warnings help audit existing libraries and enforce design-system governance.

What file structure should a UI component include?▼

A standardized component includes implementation, styles, type definitions, tests, and Storybook documentation in a single directory. This structure ensures consistency and simplifies component discovery and reuse.

Can I use design system principles with existing component libraries?▼

Yes. Design systems apply to new components, refactored libraries, and audits of existing code. You can incrementally extract hard-coded styles into tokens and standardize organization without starting from scratch.