Skip to content
Back to search

refactoring-ui-plugin

MarketplaceWorks with Claude CodeGitHub

10 applied skills for Claude Code and Cursor that turn the principles of Refactoring UI into structured AI-assisted design reviews | not affiliated, big fan, get their book here:

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/gnurio--refactoring-ui-plugin/badge.svg)](/listings/gnurio--refactoring-ui-plugin)

HTML

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

Install

Install instructions from the README

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

Claude Code

/refactor-ui --design="path/to/design.md"
/establish-visual-hierarchy --input="design-description"

Codex

@refactor-ui --design="path/to/design.md"
@apply-typography-scale --context="marketing"

Cursor

/refactor-ui evaluate --file="design.md"
/refactor-ui fix --issues="visual-hierarchy"

See [PLATFORM_GUIDE.md](./PLATFORM_GUIDE.md) for platform-specific installation and usage.

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.

.claude-plugin/marketplace.json · Manifest · 14 lines

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

  1. {
  2. "name": "refactoring-ui-plugin",
  3. "owner": {
  4. "name": "gnurio"
  5. },
  6. "plugins": [
  7. {
  8. "name": "refactoring-ui-skills",
  9. "source": "./",
  10. "description": "AI-powered UI design skills based on Refactoring UI principles.",
  11. "homepage": "https://github.com/gnurio/refactoring-ui-plugin"
  12. }
  13. ]
  14. }
README.md · README · 93 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 Skills
  2. Ten structured AI skills for evaluating and improving UI designs — covering visual hierarchy, typography, color, spacing, buttons, clutter, empty states, shadows, contrast, and grouping. Use individual skills for targeted fixes or invoke the `meta-refactor-ui` orchestrator for a full design pass.
  3. [![Skills](https://img.shields.io/badge/skills-10-blue)](./skills.json)
  4. [![Platforms](https://img.shields.io/badge/platforms-Claude%20%7C%20Codex%20%7C%20Cursor-blueviolet)](./PLATFORM_GUIDE.md)
  5. > **Attribution:** These skills are based on the principles and methodology in
  6. > [*Refactoring UI*](https://refactoringui.com/) by Adam Wathan and Steve Schoger
  7. > (© Tailwind Labs Inc.). This repository is an independent AI skill implementation
  8. > and is not affiliated with or endorsed by Tailwind Labs.
  9. ## Overview
  10. This plugin packages 10 focused UI design skills plus a `refactor-ui` meta-skill that runs a full design pass. The skills cover visual hierarchy, typography, color, spacing, button hierarchy, visual clutter, empty states, shadows, contrast, and grouping.
  11. ## Quick Start
  12. ### Claude Code
  13. ```bash
  14. /refactor-ui --design="path/to/design.md"
  15. /establish-visual-hierarchy --input="design-description"
  16. ```
  17. ### Codex
  18. ```bash
  19. @refactor-ui --design="path/to/design.md"
  20. @apply-typography-scale --context="marketing"
  21. ```
  22. ### Cursor
  23. ```bash
  24. /refactor-ui evaluate --file="design.md"
  25. /refactor-ui fix --issues="visual-hierarchy"
  26. ```
  27. See [PLATFORM_GUIDE.md](./PLATFORM_GUIDE.md) for platform-specific installation and usage.
  28. ## Skills
  29. | # | Skill | Purpose | Type |
  30. |---|-------|---------|------|
  31. | 01 | [Establish Visual Hierarchy](skills/01-establish-visual-hierarchy/SKILL.md) | Determine what draws attention first | Evaluative |
  32. | 02 | [Apply Typography Scale](skills/02-apply-typography-scale/SKILL.md) | Create hierarchy with font sizes, weights, and colors | Generative |
  33. | 03 | [Build Color Palette](skills/03-build-color-palette/SKILL.md) | Define grey, primary, and accent color scales | Generative |
  34. | 04 | [Apply Consistent Spacing](skills/04-apply-consistent-spacing/SKILL.md) | Use systematic spacing and rhythm | Generative |
  35. | 05 | [Design Button Hierarchy](skills/05-design-button-hierarchy/SKILL.md) | Separate primary, secondary, and tertiary actions | Generative |
  36. | 06 | [Eliminate Visual Clutter](skills/06-eliminate-visual-clutter/SKILL.md) | Remove unnecessary decoration | Corrective |
  37. | 07 | [Design Empty States](skills/07-design-empty-states/SKILL.md) | Create useful zero-content states | Generative |
  38. | 08 | [Use Shadows Appropriately](skills/08-use-shadows-appropriately/SKILL.md) | Use elevation functionally | Corrective |
  39. | 09 | [Manage Color Contrast](skills/09-manage-color-contrast/SKILL.md) | Preserve readability and accessibility | Evaluative |
  40. | 10 | [Group Related Elements](skills/10-group-related-elements/SKILL.md) | Use proximity to show relationships | Generative |
  41. ## Repository Layout
  42. ```text
  43. .
  44. ├── .claude-plugin/plugin.json
  45. ├── .codex-plugin/plugin.json
  46. ├── .cursor-plugin/plugin.json
  47. ├── adapters/
  48. ├── examples/
  49. ├── skills/
  50. │ ├── 01-establish-visual-hierarchy/SKILL.md
  51. │ ├── ...
  52. │ └── meta-refactor-ui/SKILL.md
  53. ├── tests/
  54. ├── PLATFORM_GUIDE.md
  55. ├── README.md
  56. ├── SKILL.md
  57. └── skills.json
  58. ```
  59. ## Development
  60. Validate the skill layout:
  61. ```bash
  62. bash tests/validate-skills.sh
  63. ```
  64. Check platform detection:
  65. ```bash
  66. node -e "console.log(require('./adapters/platform-adapter').getPlatformDisplayName())"
  67. ```
  68. ## License
  69. All rights reserved. See [LICENSE](./LICENSE).
  70. These skills are based on *Refactoring UI* by Adam Wathan and Steve Schoger (© Tailwind Labs Inc.).
  71. This repository is not affiliated with or endorsed by Tailwind Labs.

Ratings and comments

Sign in to rate this skill.

Sign in

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