ux-tooltips

ux-tooltips is a skill for Claude Code from Uxcel-Lab/product-skills. It costs 72 tokens per session (1,486 once invoked), scanned A, original, MIT.

A guide for deciding when to use tooltips—small hints that appear near an interface element—and how to place and write them. It also checks whether a tooltip is hiding information that should be visible directly.

In plain words
What is it for?
Use it when designing or reviewing hover hints, information icons, contextual help bubbles, and similar guidance. It helps decide whether a tooltip is needed, where it belongs, and how short it should be.
Why use it?
It helps prevent unclear designs from being patched with excessive hints. It also avoids making important information depend on hovering, which is unreliable on touch devices.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the uxcel plugin — 58 skills shipped together

Good fit Use it when designing or reviewing hover hints, information icons, contextual help bubbles, and similar guidance. It helps decide whether a tooltip is needed, where it belongs, and how short it should be.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/uxcel-lab/product-skills/tooltips
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add Uxcel-Lab/product-skills --skill tooltips
Clone the repo
git clone --depth 1 https://github.com/Uxcel-Lab/product-skills

Made for: Claude Code.

Or install uxcel, the plugin that ships this one along with the rest of its 58 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ux-tooltips

README.md
[![agentmods](https://agentmods.dev/badge/skills/uxcel-lab/product-skills/tooltips.svg)](https://agentmods.dev/skills/uxcel-lab/product-skills/tooltips)
Your own site
<a href="https://agentmods.dev/skills/uxcel-lab/product-skills/tooltips"><img src="https://agentmods.dev/badge/skills/uxcel-lab/product-skills/tooltips.svg" alt="Measured on agentmods" height="20"></a>
Per session 72 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,486 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00072 $0.01486
Opus 5 $0.00036 $0.00743
Sonnet 5 $0.00014 $0.00297
Haiku 4.5 $0.00007 $0.00149

Measured 8d ago against content hash 3ac6a3d2156a, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

ux-tooltips scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

ux/components/tooltips/SKILL.md · 92 lines

How it starts

The opening of the file, as written. The whole thing — 92 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Tooltips Skill

How this skill behaves (read first)

This is a generative skill. The default failure modes: tooltip-as-crutch (an unclear interface "fixed" by sprinkling hover hints everywhere), redundancy ("Submit" button + "Click to submit" tooltip), and vital info in hover space (content users must see, hidden behind an interaction many will never perform — and that touch devices can't perform reliably). A tooltip is a supplement for genuinely ambiguous elements — never a load-bearing part of the flow. This skill gates:

  1. Gate each tooltip's existence — is the element actually ambiguous, or is the design unclear?
  2. Apply the always-true core — placement, brevity, styling, cursor signaling.
  3. Surface the escalation decisions — when a tooltip is the wrong tool entirely.

Then it hands off to ux-heuristics-audit, ux-accessibility-audit, ux-aesthetics-audit, and ux-microcopy-audit for validation.


Step 0 — Gate each tooltip's existence

Three questions per tooltip:

  • Is the element genuinely ambiguous? A camera icon that could mean "take photo" or "open gallery" → tooltip earns its place. A button labeled "Submit" → no tooltip; it would only repeat the label.
  • Is the information vital to the task? Tooltips are user-triggered — many users never hover, and touch devices have no hover. Anything required to complete the flow goes in the interface (label, helper text, inline message), never in a tooltip.
  • Is this papering over a design problem? If a screen needs many tooltips, the labels, icons, or layout are failing. Fix the element; don't annotate it. (Better universal icon, visible label, or icon + label — see ux-buttons and ux-menus.)

The always-apply core (for tooltips that survive the gate)

  • Concise, essentials-only content — a bite-sized clarification ("Capture photo"), no redundancy, nothing users must strain to read.
  • Placement never blocks — the tooltip and its trigger element both stay fully visible; never cover the input or button it describes, never get cut off at screen edges.
  • Pointer cursor on hoverable triggers — signals that more information is available and ties the cursor to the pop-up.
  • Left-aligned text (LTR), modest styling, no decorative frames, ≥4.5:1 contrast between text and tooltip background.
  • Consistent treatment product-wide — one tooltip style, one trigger behavior.

Read the full file on GitHub · 92 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 92 lines · 72 tokens per session scan A 3ac6a3d2156a

Subscribe to this mod's changes

ux-tooltips is a skill published in the GitHub repository Uxcel-Lab/product-skills (10 stars, last pushed 2mo ago), licensed MIT. It adds 72 tokens to every session and 1,486 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

pm-brand-motion

A guided process for defining a brand's motion style and making a logo animation demonstration.

konglong87/superPM · 77 tokens

pm-proto

A product-prototyping workflow for planning how an application should work and what its screens should contain. It connects product requirements to interface layouts and interactions.

konglong87/superPM · 55 tokens

design-mobile-apps

Use when the user wants to design a mobile app or UI screens, when they mention their Sleek (sleek.design) projects, or when implementing Sleek designs in code (HTML, React Native, SwiftUI).

aiskillstore/marketplace · 49 tokens

dengguang-zhaoming-bikeng-zhinan

A Chinese-language knowledge guide about home lighting, including ceiling lights, light strips, color temperature, color rendering, and room zoning.

aiskillstore/marketplace · 99 tokens

archify

Create polished, validated architecture, workflow, sequence, data-flow, and lifecycle/state diagrams as explorable standalone HTML with inline SVG, dark/light themes, optional trace motion, and PNG/JPEG/WebP/SVG/WebM export. Accept plain-language requirements or pasted Mermaid flowchart, sequenceDiagram, and…

aiskillstore/marketplace · 130 tokens

landing-page-design

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section…

aiskillstore/marketplace · 102 tokens