design-system

Audit design systems for naming inconsistencies, hardcoded values, and accessibility gaps.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/FoundationForge/cowork-plugins --skill design-system-foundationforge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-system
Source: https://github.com/FoundationForge/cowork-plugins/tree/main/plugins/design/skills/design-system
Command: npx skills add https://github.com/FoundationForge/cowork-plugins --skill design-system-foundationforge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Design teams often suffer from inconsistent naming, hardcoded values, missing documentation, and accessibility gaps that slow development and increase UI drift; this Skill helps surface those issues, standardize component definitions, and produce shareable documentation and proposals for new patterns.

Core Features & Use Cases

  • System Audit: Scan components and tokens to identify naming inconsistencies, hardcoded values, and coverage gaps across the design system.
  • Component Documentation: Generate structured docs for components including variants, states, props, accessibility notes, and code examples.
  • Extend Patterns: Propose new components or patterns with API, variants, token usage, states, accessibility considerations, and open questions for design review.
  • Real-world example: Run a full audit of the button and input families to convert hardcoded colors to token references, document missing states, and produce a prioritized remediation plan.

Quick Start

Use /design-system audit to run a full system audit and generate a prioritized findings report.

Frequently Asked Questions about design-system

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

FAQPage Schema
How do I audit a design system for naming inconsistencies and hardcoded values?

To audit a design system, scan component libraries and token inventories to identify naming inconsistencies, hardcoded values, and coverage gaps. This process surfaces UI drift issues and produces a structured audit report with a prioritized remediation plan.

What is the best way to document design system components and accessibility notes?

Documenting design system components involves generating structured templates that include variants, states, props, accessibility notes, and code examples. This standardizes component definitions and creates shareable documentation for design and development teams.

How do I propose new patterns and map them to existing design tokens?

Proposing new patterns requires defining the component API, variants, token usage, and accessibility considerations. This generates extendable component proposals with token mappings and open questions for design review.

Can I use this to convert hardcoded colors in my component library to design tokens?

Yes, you can scan component families like buttons and inputs to identify hardcoded colors and convert them to token references. This standardizes token usage across the design system and reduces visual inconsistencies.

Does this design system audit check for accessibility gaps across pattern libraries?

Yes, the design system audit identifies accessibility gaps across pattern libraries and component families. It generates accessibility notes within structured documentation templates to ensure compliance and comprehensive coverage.

What do I need to run a full design system audit on my component library?

You need an existing component library, token inventory, or pattern library to run a full design system audit. The audit scans these inputs to detect missing documentation, hardcoded values, and naming inconsistencies, outputting a prioritized findings report.