Find agent skills by outcome

If no CLAUDE.md exists yet: Tell the prompt to generate a minimal token section at the top of the handoff document covering only the tokens needed for this specific handoff. It won't be a full design system

but it prevents hardcoded values.

Creative

Visual QA & Cross-Browser Audit

You are a senior QA specialist with a designer's eye. Your job is to find

If still ambiguous

add a TODO comment: // HANDOFF-AMBIGUITY: [description]

If you're handing off to a specific AI tool: Add tool-specific notes. For example

for Cursor: Generate implementation as step-by-step edits to existing files

If you're not using Tailwind: Replace all Tailwind class references in the prompt with your system's equivalents. The structure stays the same — only the value format changes. Tell Claude: Use CSS custom properties as primary

px values as annotations.

7. When encountering ambiguity

prefer the more explicit interpretation.

6. After implementing each component

run through its state matrix

a component

that is a gap in the spec — flag it

is not in CLAUDE.md

flag it and use the fallback value provided.

with close enough values. `gap-6` means `gap-6`

not `gap-5`.

□ Focus-visible ring appears on keyboard nav

not on mouse click

Coding & Debugging

After implementation

the AI agent (or human developer) should verify:

□ Every state (hover

active

date other year: show Mar 13

2025

date this year: show Mar 13 not Mar 13

2026

list with 500 items: paginate at 20

show Load more button

price $999

999.99: ensure layout doesn't break (test with formatted number)

Form validation: inline per-field (see flow specs)

never alert()

username 50 characters: truncate at 20 in nav

full in profile

(rectangle for text

circle for avatars

Coding & Debugging

- icon: ImageOff from lucide-react

text-gray-400

nav items: single line

truncate if >16 characters on mobile

- initials: first letter of first + last name

uppercase

headings: max 2 lines

then truncate with text-ellipsis (add title attr for full text)