Tooltips: AI Skill for UX Design

Tooltips is an AI skill that adds hover hints only where an element is genuinely ambiguous. Must-see information stays in the interface, never hidden behind a hover.

npx skills add Uxcel-Lab/product-skills --skill ux-tooltips

Copied

What this skill does

Helps an AI assistant add tooltips only where an element is genuinely ambiguous, never as a crutch for unclear design.

Gates every tooltip: is the element ambiguous, the information required, the design unclear?
Keeps must-see information in the interface, never behind a hover.
Writes bite-sized clarifications with no redundancy.
Positions tooltips so the trigger stays visible and nothing gets cut off.
Styles them modestly: left-aligned text, 4.5:1 contrast, one treatment product-wide.
Escalates to helper text, popovers, or onboarding patterns when a tooltip is the wrong tool.
Pairs truncated text with tooltips, a legitimate combination.

When to use it

Use it when you need an AI assistant to:

decide whether an element needs a tooltip;
review tooltips across a product;
replace hover-only help on touch devices;
write shorter tooltip copy;
position tooltips that block their triggers;
fix a screen papered over with hints.

Decisions this skill helps you make

Decision	Options
Form field instructions	Helper text below the input, not a tooltip on an info icon
Visual questions	Inline icon or graphic; tooltip as a desktop supplement
First-run education	Onboarding walkthrough patterns, not permanent tooltips
Touch-first products	Visible labels or tap-triggered popovers
Rich content	A popover, not an overstuffed tooltip
Truncated text	Truncation plus tooltip, a legitimate pairing
Ambiguous icons	A tooltip earns its place, like "Capture photo" on a camera icon