design-fix

Applies design-audit findings as one-line code fixes aligned to a design system contract.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After a design audit identifies off-system values in your UI code, someone still has to manually apply each correction. This Skill mechanically applies those findings — replacing incorrect spacing, colors, and typography values with the contract-specified ones — while tracking progress in the audit artifact. ## Core Features & Use Cases - Audit-driven fixes: Reads findings from docs/tmp/design-audit-*.md and applies the expected value from the design system contract (docs/DESIGN_SYSTEM.md). - Safe, verified changes: Confirms the current code still matches the audit before editing, skips stale findings, and runs type checks, tests, and linting afterward. - Progress tracking: Marks completed items in the audit artifact and reports fixed, skipped, and remaining counts. - Use Case: After running a design audit that flagged 20 spacing and color violations, ask the agent to fix items 1-10; it applies each one-line fix (e.g., p-3 to p-4, #6366f1 to var(--color-primary)) and checks them off in the audit file. ## Quick Start Fix all violation items from the latest design audit artifact in docs/tmp using the design system contract. Note: this Skill is deprecated; prefer the current ui-* and design-* reference skills unless you specifically need the legacy docs/DESIGN_SYSTEM.md workflow.

Frequently Asked Questions about design-fix

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

FAQPage Schema
How do I fix design audit findings in my UI code?▼

Point the agent at the audit artifact in docs/tmp and specify which items to fix, such as items 1-5 or all violations. It verifies each finding against the current code, applies the expected value from the design system contract, and marks items complete.

What is a design system contract workflow?▼

It is a legacy workflow where docs/DESIGN_SYSTEM.md defines the canonical spacing, color, and typography values, and a design audit reports deviations. This Skill applies the corrections so the code matches the contract.

Should I use design-fix for new UI work?▼

No. This Skill is deprecated and parked while the taxonomy moves to design-expert and focused design-* reference skills. Only use it when explicitly working with findings from the old design-audit and docs/DESIGN_SYSTEM.md contract workflow.

What happens if the code changed since the design audit ran?▼

The Skill verifies the current value matches what the audit reported before editing. If the code has changed, it skips the item and notes it rather than applying a stale fix.

What if a design fix breaks tests or linting?▼

Design fixes must never break functionality. If a fix causes a test or lint failure, the change is reverted and the item is flagged for manual review instead of being kept.