mcpField
D
design-debt-audit

design-debt-audit

github.com/podoDesign & UI29170 installsUpdated 4d ago
Repository

About design-debt-audit

design-debt-audit is a design review skill for identifying and prioritizing design debt in a UI. It classifies issues across five categories, scores severity against frequency and effort, and maintains a remediation register.

Key features

  1. 01Classifies visual, structural, and other design debt
  2. 02Uses a five-step audit process
  3. 03Prioritizes by severity, frequency, and effort
  4. 04Maintains a living debt register

Use cases

  1. 01Turning UI inconsistencies into a triaged backlog
  2. 02Prioritizing design issues for remediation

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/podo/design-agent-skills --skill design-debt-audit

After installing, type/design-debt-auditin Claude Code to confirm it loaded.

Bundled filesstub.yaml

Details

From the project README

design-debt-audit

Catalogue stub — full skill: Owl-Listener/designer-skills

Decision tree

  1. Is the full skill already installed?

    • Global: f=~/.agents/skills/design-debt-audit/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"
    • Project: f=.agents/skills/design-debt-audit/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"
    • installed → the skill is installed as design-debt-audit, invoke it and proceed
    • pointer → go to step 2

  2. Detect scope, then install:

    [ -e ~/.agents/skills/design-debt-audit ] && echo "global" || echo "project"

    Global:

    npx skills add Owl-Listener/designer-skills --skill design-debt-audit -g -y

    Project:

    npx skills add Owl-Listener/designer-skills --skill design-debt-audit -y

    Claude Code: send a command as a chat message starting with ! to run it without leaving the conversation.

Claude Code plugin route:

/plugin marketplace add Owl-Listener/designer-skills
/plugin install design-ops@designer-skills

Heads-up

  • License: MIT

Invoke after install

  • Skill name: design-debt-audit
  • Trigger phrases: "design debt audit", "design debt triage", "UI inconsistency audit", "design debt register"

What it does

The design-debt-audit skill from Owl-Listener's designer-skills: a debt taxonomy (visual / structural / accessibility / documentation / implementation), a five-step audit process (scope, classify, quantify, prioritize, remediate), a Severity×Frequency/Effort prioritization score, and a living debt register. Turns "the UI feels inconsistent" into a triaged, remediable backlog.

When NOT to use

  • Codebase/technical debt (not design) → a code-quality skill
  • Live accessibility violations → use wcag-audit-patterns
  • Token coverage specifically, or the rest of the designer-skills plugins → see designer-skills

Comments

Markdown supported