Skip to content
Back to search

ui-ux-marketplace

MarketplaceWorks with Claude CodeGitHub

ui-ux — Team UI/UX Skill for Claude Code

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/ramanskp--claude-skills/badge.svg)](/listings/ramanskp--claude-skills)

HTML

<a href="/listings/ramanskp--claude-skills"><img src="/api/listings/ramanskp--claude-skills/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.

In Claude Code:

/plugin marketplace add ramanskp/claude-skills
/plugin install ui-ux@ui-ux-marketplace

Restart Claude Code. Check that it's installed with `/plugin`: `ui-ux` should appear as enabled.

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 · 18 lines
  1. {
  2. "name": "ui-ux-marketplace",
  3. "owner": { "name": "Diligent Squad UI" },
  4. "metadata": {
  5. "description": "Team UI/UX standards for Claude Code",
  6. "version": "0.2.2"
  7. },
  8. "plugins": [
  9. {
  10. "name": "ui-ux",
  11. "source": "./plugins/ui-ux",
  12. "description": "Lean, stack-agnostic UI/UX team standard: principles, accessibility, a design-pattern library, and a /ux-review audit command.",
  13. "version": "0.2.2",
  14. "category": "design",
  15. "keywords": ["ui", "ux", "accessibility", "design-patterns", "design-system", "review"]
  16. }
  17. ]
  18. }
README.md · README · 132 lines
  1. # ui-ux — Team UI/UX Skill for Claude Code
  2. A lean, stack-agnostic UI/UX standard packaged as a Claude Code plugin. It contains:
  3. - **`ui-ux` skill**: triggers automatically when Claude builds or reviews UI. It has two modes, *Build* (pattern → tokens → layout → states → a11y) and *Review*.
  4. - **Design-pattern library**: 26 patterns plus 3 style presets, one Markdown file each, all following the same template.
  5. - **Commands**:
  6. - `/ux-init`: writes a project `DESIGN.md`.
  7. - `/ux-review`: audit report only, no edits.
  8. - `/ux-polish`: visual refinement and anti-pattern removal.
  9. - `/ux-harden`: adds missing states, edge cases and accessibility.
  10. - **Anti-patterns guide**: catches the generic "AI template" look (default gradients, nested cards, filler copy).
  11. Everything is plain Markdown. Edit it like documentation.
  12. ## For teammates
  13. ### 1. Install (about 1 minute, once)
  14. In Claude Code:
  15. ```text
  16. /plugin marketplace add ramanskp/claude-skills
  17. /plugin install ui-ux@ui-ux-marketplace
  18. ```
  19. Restart Claude Code. Check that it's installed with `/plugin`: `ui-ux` should appear as enabled.
  20. ### 2. Set up your project (once per repo)
  21. ```text
  22. /ux-init
  23. ```
  24. This writes a `DESIGN.md` at the project root with your stack, tokens and brand notes. Commit it so everyone on the project shares it.
  25. ### 3. Day to day
  26. | You want to… | Do this |
  27. |--------------|---------|
  28. | Build or change UI | Just ask, e.g. *"Add a filterable orders table"*. The skill applies automatically |
  29. | Check UI before a PR | `/ux-review src/components/Checkout/` (or `/ux-review` with no target for the current diff) |
  30. | Make it look less generic | `/ux-polish <file>` |
  31. | Add missing states, edge cases and accessibility | `/ux-harden <file>` |
  32. `/ux-review` returns a score and a verdict. **Any Blocker means not shippable**, whatever the score.
  33. ### 4. Stay up to date
  34. ```text
  35. /plugin marketplace update ui-ux-marketplace
  36. ```
  37. Then restart Claude Code. See [CHANGELOG.md](CHANGELOG.md) for what changed.
  38. ### Troubleshooting
  39. - **The `/ux-*` commands don't show up:** restart Claude Code after installing or updating.
  40. - **The skill doesn't kick in:** mention the UI work explicitly (page, component, form, layout, accessibility). It deliberately stays out of backend-only tasks.
  41. - **It conflicts with your project's design system:** put the overrides in `DESIGN.md`. Project rules win over the team defaults.
  42. - **Found a gap or a wrong rule?** Open an issue or PR. See [Contributing a pattern](#contributing-a-pattern).
  43. ## Install
  44. ### Option A — Marketplace (recommended, gets updates)
  45. ```text
  46. /plugin marketplace add ramanskp/claude-skills
  47. /plugin install ui-ux@ui-ux-marketplace
  48. ```
  49. Restart Claude Code. Update later with `/plugin marketplace update ui-ux-marketplace`.
  50. To roll it out to a whole project, commit this to the project's `.claude/settings.json`:
  51. ```json
  52. {
  53. "extraKnownMarketplaces": {
  54. "ui-ux-marketplace": { "source": { "source": "git", "url": "https://github.com/ramanskp/claude-skills.git" } }
  55. },
  56. "enabledPlugins": { "ui-ux@ui-ux-marketplace": true }
  57. }
  58. ```
  59. ### Option B — Local clone (for contributors)
  60. ```text
  61. /plugin marketplace add ./path/to/ui-ux-skill
  62. /plugin install ui-ux@ui-ux-marketplace
  63. ```
  64. ### Option C — Skill folder only (no plugin, no command)
  65. ```bash
  66. cp -r plugins/ui-ux/skills/ui-ux ~/.claude/skills/ui-ux # personal
  67. cp -r plugins/ui-ux/skills/ui-ux <project>/.claude/skills/ui-ux # per project
  68. ```
  69. ## Use
  70. - Just ask: *"Build a settings page with a danger zone"* or *"Add a filterable orders table"*. The skill picks the matching patterns.
  71. - Per project, run `/ux-init` once and commit the generated `DESIGN.md`. Its token overrides and rules then apply to every build and review in that repo.
  72. - Refine: `/ux-polish src/pages/Pricing.tsx` for look and feel, `/ux-harden src/components/OrdersTable/` for robustness.
  73. - Audit: `/ux-review src/components/Checkout/`, `/ux-review https://staging.example.com/signup`, or `/ux-review` with no argument to review the current diff.
  74. ## Layout
  75. ```
  76. plugins/ui-ux/
  77. ├── .claude-plugin/plugin.json
  78. ├── commands/ # ux-init, ux-review, ux-polish, ux-harden
  79. └── skills/ui-ux/
  80. ├── SKILL.md # entry point, kept short
  81. └── references/
  82. ├── principles.md # ← brand tokens: edit these
  83. ├── accessibility.md # WCAG 2.2 AA checklist
  84. ├── states-and-feedback.md
  85. ├── layout-responsive.md
  86. ├── review-checklist.md # ← severity rubric: edit this
  87. ├── anti-patterns.md # generic-AI look to avoid
  88. ├── DESIGN.template.md # per-project overrides (via /ux-init)
  89. ├── stacks/ # web-css, react, mobile adapters
  90. └── patterns/
  91. ├── INDEX.md # problem → pattern routing + decision guides
  92. ├── _TEMPLATE.md
  93. ├── navigation/ forms/ data-feedback/ flows/ styles/
  94. ```
  95. ## Customize for your team
  96. 1. **Per project**: use a root `DESIGN.md` (via `/ux-init`). No need to fork the plugin.
  97. 2. **Team-wide brand**: change the values (not the names) in `references/principles.md`.
  98. 3. **Review severity**: fill in the rubric in `references/review-checklist.md`.
  99. 4. **Stack**: add `references/stacks/<your-stack>.md` and a row to the reference map in `SKILL.md`.
  100. ## Contributing a pattern
  101. 1. Copy `patterns/_TEMPLATE.md` to `patterns/<group>/<name>.md` and keep every heading.
  102. 2. Add a row to `patterns/INDEX.md`.
  103. 3. Run `./scripts/check-patterns.sh`.
  104. 4. Bump `version` in **both** `plugins/ui-ux/.claude-plugin/plugin.json` and `.claude-plugin/marketplace.json` (minor for new patterns, patch for fixes) and add a line to `CHANGELOG.md`.
  105. ## Relationship to other UI skills
  106. This is a short, opinionated team standard. If you also use a large reference skill (for example `ui-ux-pro-max` for style and palette search), the two complement each other. When guidance conflicts, this skill wins on team rules.
  107. ## Acknowledgements
  108. The anti-patterns guide, refinement commands and `DESIGN.md` convention were inspired by [Impeccable](https://github.com/pbakaus/impeccable) (Apache-2.0). The content here is written independently.
  109. ## License
  110. MIT. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

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