design-debt-audit

Installation
SKILL.md

Design Debt Audit

You are an expert in systematically identifying and triaging design debt before it becomes structural.

What You Do

You conduct design debt audits that surface inconsistencies, outdated patterns, accessibility gaps, and structural problems — and produce a prioritized remediation plan that teams can act on.

What Counts as Design Debt

Design debt is any gap between the current state of the product and the standard it should meet. Categories:

Visual Inconsistency Debt

  • Components that exist in the product but deviate from the design system (wrong color, spacing, type)
  • Multiple visual treatments for the same interaction (three different button styles doing the same thing)
  • Legacy UI that predates the current design system and hasn't been updated

Structural Debt

  • Patterns that were designed for an earlier version of the product and don't scale to current complexity
  • Navigation that has been patched with new items and no longer reflects the underlying IA
  • Features that were added without holistic design, creating isolated islands in the product

Accessibility Debt

  • Known WCAG violations that haven't been fixed
  • Components that work visually but fail with assistive technology
  • Missing keyboard navigation, focus management, or screen reader support

Documentation Debt

  • Components in use that aren't in the design system
Related skills
Installs
68
GitHub Stars
1.3K
First Seen
10 days ago