ui-lint – Design & UI skill for AI agents

Design Lint (Quick Check)

When to Use

Use this skill when you need quick automated lint — detects common design system violations in seconds.

When NOT to use

• For deeper review of design judgment (composition, hierarchy, rhythm) → use /ss-review
• For accessibility specifically → use /ss-a11y
• For Nielsen UX heuristics → use /ss-audit
• For applying refactors — this only flags violations; use /ss-review to fix

Target: $ARGUMENTS

What This Does

Fast, grep-based candidate scan. First read the project design tokens and conventions: pure black, physical spacing, data-slot, cn() and size-* are project-dependent choices, not universal violations. Replace [file] with a quoted actual path. The /ss-* commands are upstream host conventions and may not be installed. Inspect each match in context before reporting a defect.

Checks

1. Hardcoded Colors

Search for hex colors in className strings that should be semantic tokens:

grep -n '#[0-9a-fA-F]\{3,8\}' [file] | grep -v 'theme.css\|tokens\|\.json'

Violation: text-[#3C3C3C], bg-[#721FE5]

Fix: text-text-primary, bg-brand

2. Raw Pixel Values in Tailwind

grep -n 'p-\[.*px\]\|m-\[.*px\]\|gap-\[.*px\]' [file]

Violation: p-[24px], gap-[12px]

Fix: p-6, gap-3

3. Old Width/Height Syntax

grep -n 'w-[0-9] h-[0-9]\|w-\[.*\] h-\[' [file]

Violation: w-4 h-4

Fix: size-4

4. Physical Properties (LTR-only)

grep -n ' ml-\| mr-\| pl-\| pr-' [file]

Violation: ml-2, mr-4

Fix: ms-2, me-4

5. Forbidden Colors

grep -n 'text-black\|bg-black\|#000000\|#000"' [file]

Violation: Any pure black

Fix: Use skin's text-primary token

6. Missing data-slot

grep -n 'function [A-Z]' [file] # find components
grep -n 'data-slot' [file]       # check if present

Violation: Component without data-slot

Fix: Add data-slot="component-name"

7. Ambiguous Font Size Arbitrary Values

grep -n 'text-\[var(--' [file]
grep -n '\-\-text-.*px\|--fs-.*px' [file]

Check: An arbitrary text-[var(...)] value may need a length type hint. Tailwind v4 intentionally uses the --text-* namespace for font-size theme tokens; defining --text-sm is valid. Prefer the semantic text-sm utility or explicit text-(length:--custom-size) when needed. Verify compiled CSS. See [official font-size documentation](https://tailwindcss.com/docs/font-size).

8. className Without cn()

grep -n 'className={`' [file]

Violation: Template literal className

Fix: Use cn() for all className composition

Output Format

🔴 FAIL  [file:line] Hardcoded hex: text-[#3C3C3C] → use text-text-primary
🔴 FAIL  [file:line] Raw px: p-[24px] → use p-6
🟡 WARN  [file:line] Physical prop: ml-2 → use ms-2
🟡 WARN  [file:line] Missing data-slot on MyComponent
🟢 PASS  No violations found

Total: X errors, Y warnings

If errors > 0, list specific fixes for each violation.

Limitations

• Use this skill only when the task clearly matches its upstream source and local project context.
• Verify commands, generated code, dependencies, credentials, and external service behavior before applying changes.
• Do not treat examples as a substitute for environment-specific tests, security review, or user approval for destructive or costly actions.