grid-cards

Chooses between tooltips and hover cards for grid squares based on action count.

2|1|Updated Jun 28, 2026
One-click install
npx skills add https://github.com/lxsmnsyc/overwander --skill grid-cards-lxsmnsyc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grid-cards
Source: https://github.com/lxsmnsyc/overwander/tree/main/.claude/skills/grid-cards
Command: npx skills add https://github.com/lxsmnsyc/overwander --skill grid-cards-lxsmnsyc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Grid squares in item and candy trays need a consistent interaction pattern: a square must be readable without pressing it, and a hover card should only appear when the square offers more than one action. Without a rule, developers add cards that cover the tray unnecessarily or bury actions inside tooltips that cannot hold buttons. ## Core Features & Use Cases - Action-count rule: Zero or one action renders a tooltip with the square's name and line; two or more actions render a hover card with buttons in its foot. - Automatic counting via ItemGrid: An ItemCell lists its actions in an actions array, and ItemGrid counts them so callers never pick the presentation manually. - Card body discipline: Anything pressable inside a card body must be declared as an action, or it becomes unreachable when the square drops to one action and reverts to a tooltip. - Use Case: When adding a square to an auction tray that offers both "visit seller" and "bid", declare both as actions so the square renders a hover card with two buttons instead of an inline link that breaks later. ## Quick Start When adding a square to an item or candy tray, list everything it can do in the cell's actions array and let ItemGrid decide between a tooltip and a hover card.

Frequently Asked Questions about grid-cards

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a hover card to a grid square in a tray?▼

List two or more entries in the cell's actions array, each with a label and onPress handler. ItemGrid counts the actions and renders a hover card with the actions drawn as buttons in its foot automatically.

When should a grid square use a tooltip instead of a hover card?▼

Use a tooltip when the square has zero or one action. A tooltip shows the square's name and line without covering the tray, and a single action runs as the square's own press since a tooltip cannot hold buttons.

Why did a button inside my hover card stop working?▼

Pressable elements inside a card body must be declared as actions. If the square drops to one action it becomes a tooltip, and any undeclared inline button or link becomes unreachable because tooltips vanish when the pointer leaves.

Does the grid-cards pattern apply to the pokemon box?▼

No, the pokemon box is explicitly excluded. A catch square carries a record rather than a name, and its card is the record itself, so the tooltip-versus-card counting rule does not apply there.

What happens to the tray's onPress when a cell declares actions?▼

Once a cell lists actions, it has fully described what its square does, so the tray's onPress and cardOnly props no longer reach that cell. The declared actions take over the square's behavior entirely.