agentleFS
Cor-IncorporatedCor-Incorporated/claude-code-skills/skills/ui-skills/SKILL.md

ui-skills

Skill5 starsChanged 2 months agoMITView on GitHub

Opinionated UI constraints for Tailwind CSS, accessibility, animation, and layout. Use when building, reviewing, or fixing UI components. Triggers: 'review this component', 'check UI quality', 'build a form/modal/dialog', 'fix animation jank', 'accessible button'. Do NOT use for backend logic, API design, or database work.

12 other projects use a version of this, 5 of them edited.

Adopted by

Most recently taken up by

Used with

Projects with it also use ui-ux-pro-max.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • StrayDragonSkill

    ui-ux-pro-max

    UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 8 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient.

    Also in 3 projects that use this

The file

Show its rules and text

We split this skill into the rules it gives an agent

36 rules. 3 are common, 11 are distinctive, and 22 are very specific to this project.

  • 3

    Common

    Most of the 9 edited versions we read keep these.

  • 11

    Distinctive

    This author's own choices. Worth a look.

  • 22

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use Tailwind CSS defaults unless custom values already exist or are explicitly requested.

    line 13
  2. Very specific:

    Use motion/react (formerly framer-motion) for JavaScript animation.

    line 14
  3. Very specific:

    Use tw-animate-css for entrance and micro-animations.

    line 15
  4. Very specific:

    Use cn utility (clsx + tailwind-merge) for class logic.

    line 16
  5. Very specific:

    Use accessible primitives (Base UI, React Aria, Radix) for keyboard/focus behavior.

    line 20
  6. Distinctive:

    Use the project's existing component primitives first.

    line 21
  7. Distinctive:

    NEVER mix primitive systems within the same interaction surface.

    line 22
  8. Very specific:

    Prefer Base UI for new primitives if compatible.

    line 23
  9. Very specific:

    Add aria-label to icon-only buttons.

    line 24
  10. Distinctive:

    NEVER rebuild keyboard or focus behavior by hand.

    line 25
  11. Very specific:

    Use AlertDialog for destructive or irreversible actions.

    line 29
  12. Distinctive:

    Use structural skeletons for loading states.

    line 30
  13. Very specific:

    Use h-dvh instead of h-screen.

    line 31
  14. Very specific:

    NEVER block paste in input or textarea.

    line 34
  15. Distinctive:

    NEVER add animation unless explicitly requested.

    line 38
  16. Very specific:

    NEVER animate layout properties (width, height, top, left, margin, padding).

    line 40
  17. Very specific:

    Avoid animating paint properties (background, color) except for small local UI.

    line 41
  18. Very specific:

    Use ease-out on entrance.

    line 42
  19. Very specific:

    NEVER exceed 200ms for interaction feedback.

    line 43
  20. Distinctive:

    NEVER introduce custom easing curves unless explicitly requested.

    line 46
  21. Very specific:

    Use text-balance for headings, text-pretty for body/paragraphs.

    line 50
  22. Very specific:

    Use tabular-nums for data.

    line 51
  23. Very specific:

    Use truncate or line-clamp for dense UI.

    line 52
  24. Very specific:

    NEVER modify letter-spacing unless explicitly requested.

    line 53
  25. Very specific:

    Use a fixed z-index scale (no arbitrary z-*).

    line 57
  26. Very specific:

    Use size-* for square elements instead of w-* + h-*.

    line 58
  27. Very specific:

    NEVER animate large blur() or backdrop-filter surfaces.

    line 62
  28. Very specific:

    NEVER apply will-change outside an active animation.

    line 63
  29. Very specific:

    NEVER use useEffect for anything expressible as render logic.

    line 64
  30. Common:

    NEVER use gradients unless explicitly requested.

    line 68
  31. Common:

    NEVER use purple or multicolor gradients.

    line 69
  32. Common:

    NEVER use glow effects as primary affordances.

    line 70
  33. Distinctive:

    Use Tailwind default shadow scale unless explicitly requested.

    line 71
  34. Distinctive:

    Use existing theme or Tailwind color tokens before introducing new ones.

    line 74
  35. Distinctive:

    If a constraint conflicts with an explicit user request, follow the user request and note the deviation.

    line 78
  36. Distinctive:

    If a component violates multiple constraints, report all violations sorted by severity (accessibility > performance > design).

    line 79

“Common” is measured: kept by at least 6 in 10 of the 9 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

UI Skills

Apply these constraints to all UI work. When reviewing a file, output: violation (exact line), why it matters (1 sentence), concrete fix (code).

Stack

  • Use Tailwind CSS defaults unless custom values already exist or are explicitly requested.
  • Use motion/react (formerly framer-motion) for JavaScript animation.
  • Use tw-animate-css for entrance and micro-animations.
  • Use cn utility (clsx + tailwind-merge) for class logic.

Components

  • Use accessible primitives (Base UI, React Aria, Radix) for keyboard/focus behavior.
  • Use the project's existing component primitives first.
  • NEVER mix primitive systems within the same interaction surface.
  • Prefer Base UI for new primitives if compatible.
  • Add aria-label to icon-only buttons.
  • NEVER rebuild keyboard or focus behavior by hand.

Interaction

  • Use AlertDialog for destructive or irreversible actions.
  • Use structural skeletons for loading states.
  • Use h-dvh instead of h-screen.
  • Respect safe-area-inset for fixed elements.
  • Show errors next to where the action happens.
  • NEVER block paste in input or textarea.

Animation

  • NEVER add animation unless explicitly requested.
  • Animate only compositor props (transform, opacity).
  • NEVER animate layout properties (width, height, top, left, margin, padding).
  • Avoid animating paint properties (background, color) except for small local UI.
  • Use ease-out on entrance.
  • NEVER exceed 200ms for interaction feedback.
  • Pause looping animations when off-screen.
  • Respect prefers-reduced-motion.
  • NEVER introduce custom easing curves unless explicitly requested.

Typography

  • Use text-balance for headings, text-pretty for body/paragraphs.
  • Use tabular-nums for data.
  • Use truncate or line-clamp for dense UI.
  • NEVER modify letter-spacing unless explicitly requested.

Layout

  • Use a fixed z-index scale (no arbitrary z-*).
  • Use size-* for square elements instead of w-* + h-*.

Performance

  • NEVER animate large blur() or backdrop-filter surfaces.
  • NEVER apply will-change outside an active animation.
  • NEVER use useEffect for anything expressible as render logic.

Design

  • NEVER use gradients unless explicitly requested.
  • NEVER use purple or multicolor gradients.
  • NEVER use glow effects as primary affordances.
  • Use Tailwind default shadow scale unless explicitly requested.
  • Give empty states one clear next action.
  • Limit accent color to one per view.
  • Use existing theme or Tailwind color tokens before introducing new ones.

Error Handling

  • If a constraint conflicts with an explicit user request, follow the user request and note the deviation.
  • If a component violates multiple constraints, report all violations sorted by severity (accessibility > performance > design).

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.