audit-design-system

Audit frontend projects against SPEC-CSS.md, SPEC-SPACING.md, and RULES-UI.md for token usage, theming, and component reuse.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/dthompson-jti/safety-check-app-concept --skill audit-design-system
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audit-design-system
Source: https://github.com/dthompson-jti/safety-check-app-concept/tree/main/.agent/skills/audit/design-system
Command: npx skills add https://github.com/dthompson-jti/safety-check-app-concept --skill audit-design-system

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The design-system audit helps teams enforce token usage, theming, and component reuse to maintain a cohesive UI across projects.

Core Features & Use Cases

  • Invariant checks: Validate adherence to SPEC-CSS.md, SPEC-SPACING.md, and RULES-UI.md; flag violations with priority labels for quick remediation.
  • Tokening & theming validation: Ensure semantic tokens are used and light/dark mode is supported consistently.
  • Component reuse enforcement: Promote reuse of existing components over custom, inline styling.

Quick Start

Initiate a design-system audit by comparing the current project files to SPEC-CSS.md, SPEC-SPACING.md, and RULES-UI.md to identify violations.

Frequently Asked Questions about audit-design-system

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

FAQPage Schema
How do I audit frontend projects for design system compliance and token usage?

To audit design system compliance, compare your frontend project files against SPEC-CSS.md, SPEC-SPACING.md, and RULES-UI.md to identify violations. The audit enforces semantic token usage, theming consistency, and component reuse across sprints.

What is design system token and theming validation for UI consistency?

Design system token and theming validation ensures frontend implementations use semantic tokens consistently and support light and dark mode. This process checks your project against established SPEC files to maintain cohesive UI theming.

How do I enforce component reuse and prevent inline styling in my design system?

Enforce component reuse by auditing frontend code against RULES-UI.md to flag custom inline styling violations. The audit promotes existing component usage over custom styles and labels violations by priority for quick remediation.

Do I need SPEC-CSS.md and SPEC-SPACING.md files to run a design system audit?

Yes, running a design system audit requires alignment with SPEC-CSS.md, SPEC-SPACING.md, and RULES-UI.md. These SPEC files define the invariant checks needed to validate token usage and component reuse across the project.

Can I check design handoffs for light and dark mode theming support?

Yes, you can check design handoffs for light and dark mode theming support by validating semantic token usage across the project. The audit ensures theming consistency by flagging areas where dark mode support is missing or incorrect.

What's the best way to flag design system violations for quick remediation across sprints?

The best way to flag design system violations is to run an audit that checks implementations against your SPEC files and applies priority labels to each violation. This prioritization guides remediation efforts across sprints and design handoffs.