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.