Skip to content
Back to search

refactoring-ui-skill

Agent skill for professional UI design based on Refactoring UI principles. Covers hierarchy, typography, color, spacing, dark mode, forms, accessibility, and animation.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jaywilburn--refactoring-ui-skill/badge.svg)](/listings/jaywilburn--refactoring-ui-skill)

HTML

<a href="/listings/jaywilburn--refactoring-ui-skill"><img src="/api/listings/jaywilburn--refactoring-ui-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code / Warp / Cursor

# Clone to your skills directory
git clone https://github.com/jaywilburn/refactoring-ui-skill.git ~/.agents/skills/refactoring-ui

Or copy `skills/refactoring-ui/SKILL.md` to your preferred skills location: - Claude Code: `~/.claude/skills/refactoring-ui/` - Codex CLI: `~/.codex/skills/refactoring-ui/` - Cursor: `.cursor/skills/refactoring-ui/`

Via npx (once indexed)

npx skills add jaywilburn/refactoring-ui-skill/refactoring-ui

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 91 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Refactoring UI Design Skill
  2. An opinionated agent skill for building professional UI without a designer, based on [Refactoring UI](https://www.refactoringui.com/) principles by Adam Wathan & Steve Schoger.
  3. ## What This Skill Covers
  4. ### Design Thinking
  5. - **Design Personality & Tone** — Formal/casual, reserved/expressive framework with domain anchors
  6. - **Color Theory & Psychology** — Color wheel, harmony schemes, hue psychology, saturation as a design lever
  7. - **Layout Decision Framework** — Content-first layout selection, density spectrum, domain layout profiles
  8. - **Breaking AI Defaults** — Named anti-patterns (purple gradients, SaaS templates) with concrete alternatives
  9. - **Component Variation** — Same component, different design based on context
  10. ### Execution
  11. - **Visual Hierarchy** — Size, weight, and color as tools for emphasis
  12. - **Typography** — Modular scales, line height, letter spacing, weight strategy
  13. - **Color** — HSL palettes, UI states, warm/cool grays, accessibility
  14. - **Spacing** — Consistent scales, proximity relationships
  15. - **Layout** — Max-width constraints, breathing room, alignment
  16. - **Mobile-First** — Breakpoint strategy, touch targets, responsive typography
  17. - **Depth & Shadows** — Elevation systems, natural shadow direction
  18. - **Dark Mode** — Systematic approach (not just inverted colors)
  19. - **Form Patterns** — Input styling, labels, errors, field grouping
  20. - **Accessibility** — Focus states, motion sensitivity, semantic HTML
  21. - **Animation** — Timing, easing, what to animate
  22. - **Design Audit Checklist** — Structured review framework
  23. ## Installation
  24. ### Claude Code / Warp / Cursor
  25. ```bash
  26. # Clone to your skills directory
  27. git clone https://github.com/jaywilburn/refactoring-ui-skill.git ~/.agents/skills/refactoring-ui
  28. ```
  29. Or copy `skills/refactoring-ui/SKILL.md` to your preferred skills location:
  30. - Claude Code: `~/.claude/skills/refactoring-ui/`
  31. - Codex CLI: `~/.codex/skills/refactoring-ui/`
  32. - Cursor: `.cursor/skills/refactoring-ui/`
  33. ### Via npx (once indexed)
  34. ```bash
  35. npx skills add jaywilburn/refactoring-ui-skill/refactoring-ui
  36. ```
  37. ## When It Triggers
  38. The skill activates when you're:
  39. - Creating new pages or components
  40. - Making design additions or changes
  41. - Asking about colors, fonts, spacing, layout
  42. - Discussing "how should this look"
  43. - Reviewing or critiquing existing interfaces
  44. - Working on responsive/mobile design
  45. ## Example Prompts
  46. ```
  47. "How should I style this card component?"
  48. "What colors should I use for this dashboard?"
  49. "Make this form look more professional"
  50. "Review this page layout"
  51. "Help me set up a consistent spacing system"
  52. ```
  53. ## Differentiators
  54. Unlike other UI design skills, this one fights AI-generated sameness head-on:
  55. 1. **Design Thinking Layer** — Strategic decisions (personality, color theory, layout strategy) before tactical execution
  56. 2. **Anti-AI-Sameness** — Explicitly names and provides alternatives to common AI defaults (purple gradients, SaaS templates, uniform card grids)
  57. 3. **Color Theory & Psychology** — Full color wheel, harmony schemes, hue psychology, and saturation strategies — not just "pick a palette"
  58. 4. **Domain-Aware Design** — Personality profiles and layout patterns for fintech, healthcare, e-commerce, creative tools, dev tools, and more
  59. 5. **Component Variation** — Cards, navs, buttons, and tables styled differently based on context, not copied from a template
  60. 6. **Dark Mode Design** — Surface hierarchy, saturation shifts, proper dark palettes
  61. 7. **Form Design Patterns** — Complete form styling guidance
  62. 8. **Accessibility Section** — Beyond contrast ratios (focus, motion, semantics)
  63. 9. **Animation Principles** — Timing, easing, what to animate
  64. 10. **Design Audit Checklist** — Structured review process including personality and intent checks
  65. ## Credits
  66. Based on [Refactoring UI](https://www.refactoringui.com/) by Adam Wathan & Steve Schoger.
  67. **This skill does not replace the book.** If you want to truly understand UI design as a developer, buy and read Refactoring UI — it's one of the most practical design resources available.
  68. ## License
  69. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.