plan-design-fixes

Transforms design audit artifacts into a prioritized, sequenced tracker of design fix work items.

1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/pnewsam/skills --skill plan-design-fixes-pnewsam
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plan-design-fixes
Source: https://github.com/pnewsam/skills/tree/main/archive/plan-design-fixes
Command: npx skills add https://github.com/pnewsam/skills --skill plan-design-fixes-pnewsam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After running a design-polish, design-review, or design-audit pass, teams often end up with a long list of findings spanning different effort levels and execution paths. This Skill converts those findings into a structured, prioritized plan so fixes can be executed in the right order without conflicts or duplicated work. ## Core Features & Use Cases - Finding Classification: Parses findings from design-polish, design-review, or design-audit artifacts and classifies each by effort, type, and execution path (direct fix, design-fix, feature work, or design system gap). - Sequenced Tracker Generation: Groups items by file and component, orders them by dependency and impact, and writes a tracker file at docs/tmp/design-fixes-{target}.md. - Idempotent Replanning: Rerunning with the same artifact skips duplicates and preserves existing item statuses using stable content-derived item IDs. - Use Case: After a design audit of a dashboard page produces 15 findings, use this Skill to generate a tracker that batches mechanical spacing fixes first and schedules the page restructure last. ## Quick Start Plan the design fixes from the most recent design-review artifact in docs/tmp and create a tracker file. Note: this Skill is deprecated for new work; prefer ui-expert, design-expert, and focused ui-/design- skills unless planning from legacy design artifacts.

Frequently Asked Questions about plan-design-fixes

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

FAQPage Schema
How do I turn design audit findings into an actionable plan?▼

Run this planning workflow on the design-polish, design-review, or design-audit artifact in docs/tmp. It parses every finding, classifies each by effort and execution path, sequences them to avoid conflicts, and writes a tracker file with ready-to-execute work items.

What execution paths does design fix planning support?▼

Findings are routed to four paths: direct fixes for one-line changes, design-fix for mechanical design system deviations, normal feature work for component or page restructures, and create-design-system for missing tokens or patterns.

Should I still use plan-design-fixes for new design work?▼

No, it is deprecated. For new UI or design work, use ui-expert, design-expert, and the focused ui-*/design-* reference skills. Only use this planner when explicitly working from old design-polish, design-review, or design-audit artifacts.

Does replanning from the same artifact create duplicate items?▼

No. The planner is idempotent: it derives stable item IDs from finding content, checks for an existing tracker, skips duplicates, and preserves the status of items already in progress or done.

When should I skip design fix planning entirely?▼

Skip it when the source artifact contains only two or three trivial fixes. In that case, apply the fixes directly instead of generating a tracker, since the planning overhead outweighs the benefit.