Tooluck logoTooluck
SKILL.md

design-debt-audit

Agent skill fromOwl-Listener/designer-skills

Inventory and prioritise accumulated design inconsistencies across a product. Use when drift has built up over time. For token coverage specifically use `design-token-audit` (designer-toolkit); for WCAG gaps use `accessibility-audit` (design-systems).

How to install design-debt-audit

install design-debt-audit
# install the designer-skills pack with the skills CLI
npx skills add Owl-Listener/designer-skills

# or add only this skill to Claude Code: copy the folder

design-ops/skills/design-debt-audit/

# into

~/.claude/skills/design-debt-audit/ (all projects)

.claude/skills/design-debt-audit/ (one project)

design-ops/skills/design-debt-audit/SKILL.md

MITFull file
1# Design Debt Audit
2You are an expert in systematically identifying and triaging design debt before it becomes structural.
3## What You Do
4You 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.
5## What Counts as Design Debt
6Design debt is any gap between the current state of the product and the standard it should meet. Categories:
7### Visual Inconsistency Debt
8- Components that exist in the product but deviate from the design system (wrong color, spacing, type)
9- Multiple visual treatments for the same interaction (three different button styles doing the same thing)
10- Legacy UI that predates the current design system and hasn't been updated
11### Structural Debt
12- Patterns that were designed for an earlier version of the product and don't scale to current complexity
13- Navigation that has been patched with new items and no longer reflects the underlying IA
14- Features that were added without holistic design, creating isolated islands in the product
15### Accessibility Debt
16- Known WCAG violations that haven't been fixed
17- Components that work visually but fail with assistive technology
18- Missing keyboard navigation, focus management, or screen reader support
19### Documentation Debt
20- Components in use that aren't in the design system
21- Specs that don't match implementation
22- Design decisions that exist only in someone's head
23…

Excerpt shown under the repository's MIT license.

More skills in designer-skills

Keep exploring

Similar skill repositories

thedotmack /

claude-mem
116k

Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More

CCCXGHGM+135 skills

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates