playful-design/router

keyboard

Walks a running page with the keyboard alone, records every focus stop and reports controls it cannot reach, see or operate.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/playful-design/router --skill keyboard

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Keyboard

This skill puts the mouse away and walks a running page with keys alone. It records every focus stop in order and returns a numbered report of what the keyboard cannot reach, see or operate.

Every stop pressed, never read from the code

Focus order, reach and operation are judged from keys pressed in the running page. A stop the walk did not press is Not verified, never assumed. One unreachable control is a finding however minor the control.

How the focus ring looks, dialog focus traps and accessible names belong to defaults, and a failure there cites its id. Opening the running result belongs to verify. Forcing hidden states open belongs to lab.

1. Load the recorder

Open the page at the state the user named and click nothing. Run tabstops.js through the browser's evaluate call. It returns pointer targets with no keyboard way in, then records each stop as keys are pressed. Judging order or reach from the markup is keyboard-press-the-keys.

Send keys through trusted input, such as Playwright's keyboard.press or the operating system. A dispatched DOM KeyboardEvent never moves focus, so a walk with no stops means the keys never arrived.

2. Walk forward, then back

Press Tab from the top of the page until focus leaves it, then Shift+Tab back to the start. Read window.__keyboard.stops and call window.__keyboard.highlight().

Stops follow the reading order of the layout. A jump from the header to the footer and back, or any positive tabindex, is keyboard-order-follows-layout.

Every stop shows an indicator on screen. A stop with no visible ring is keyboard-see-every-stop. Focus landing on links inside a closed drawer is keyboard-no-hidden-stops. A stop with no name cites defaults-name-icon-buttons.

When navigation comes before the main content, the first stop is a skip link to it. Twenty header stops before the first result is keyboard-skip-link.

3. Reach every control

Compare the stops against what the page shows and against the recorder's unreachable list. A clickable div the walk never lands on is keyboard-reach-every-control.

4. Operate each control

Enter and Space press buttons, Enter follows links and Space toggles checkboxes and switches. A control that answers a click but no key is keyboard-operate-every-control.

Menus, tabs, radio groups, listboxes and grids take one Tab stop, and arrows move inside them. A menu where every item is its own Tab stop is keyboard-arrows-inside-composites.

Escape closes the open menu, popover, sheet or dialog. An overlay that only a click can close is keyboard-escape-closes.

5. Open and close each overlay

Open each dialog, menu and popover from the keyboard. Focus moves inside, stays inside a modal and returns to the trigger on close. A failure cites defaults-trap-and-return-focus.

6. Remove something, then find focus

Delete a row, dismiss a toast, collapse a section and submit a form from the keyboard. Focus lands on a neighbour, the container or the result. A stop the recorder marks lost, with focus left on body, is keyboard-focus-survives-removal.

7. Report the walk

Return the stops as a numbered list of role and name, with the screenshot showing the highlight() numbers. Cite each finding by its stop number and the key that failed. A finding with no stop and no key is keyboard-numbered-walk.

The pair

Every check is a pair. The broken line sits beside the line that replaces it.

RuleBrokenReplacement
keyboard-press-the-keys"The markup uses buttons, so it is reachable"The walk recorded with Tab and Shift+Tab
keyboard-order-follows-layouttabindex="3" on the search fieldNo positive tabindex, the field placed in reading order
keyboard-see-every-stopStop 7 focused with no visible ringStop 7 showing the project's :focus-visible outline
keyboard-no-hidden-stopsTab landing on links in the closed drawerinert on the drawer while it is closed
keyboard-skip-linkTwenty header stops before the first resultA Skip to Content link as stop 1
keyboard-reach-every-control<div onClick={openRow}><button onClick={openRow}>
keyboard-operate-every-controlA switch that toggles on click onlySpace toggles it
keyboard-arrows-inside-compositesEight Tab stops inside one menuOne stop, arrows move between items
keyboard-escape-closesA popover that closes on outside click onlyEscape closes it and focus returns to the trigger
keyboard-focus-survives-removalFocus on body after deleting a rowFocus on the next row
keyboard-numbered-walk"Keyboard support is patchy""Stop 12, Space does nothing on Notifications"

Reporting

Severity. HIGH is a control the keyboard cannot reach or operate, or focus lost to body after an action. MEDIUM is a stop out of reading order, a stop with no visible ring or a stop hidden off screen. It is also a composite with a Tab stop per item, or an overlay Escape does not close. LOW is a missing skip link, or a report without numbered stops.

Format. One finding per root cause, numbered and citing the stop:

1. file:line - [rule-id] stop N, key, what is wrong

Cite the recorder's element when the source line is not found. Then a Rule | Count | Severity summary. Block when any HIGH remains, Approve otherwise. Mark content inside cross-origin frames as Not verified.

from this repository

More skills

All skills
playful-design
Community

alignment

Measures a running page for edges, gaps, centring and radii that miss by a pixel or two, then judges visual weight and returns a numbered report with proof.

1h installs
2
GitHub stars
13
Updated
Nov 5
playful-design
Community

animate

Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a component feel alive, or build a transition. For critiquing existing motion use review-animations; for auditing a whole codebase use improve-animations.

1h installs
2
GitHub stars
13
Updated
Nov 5
playful-design
Community

animate-expo

Build animations in React Native and Expo, making the decisions in the order that determines whether they feel right — should it animate, which thread it runs on, which properties, spring or timing, how the gesture hands off, how it degrades. Writes the implementation with Reanimated, Gesture Handler, Expo Router and expo-haptics. Use when animating anything in an Expo app, adding gestures, sheets, screen transitions, press feedback or haptics, or fixing motion that stutters on device. For web a

1h installs
2
GitHub stars
13
Updated
Nov 5
playful-design
Community

animation-performance

Keep web animations inside the frame budget — animate composite-only properties, keep motion off the main thread when the page is busy, and find the cause when an animation drops frames. Covers the layout/paint/composite pipeline, cheaper property swaps, CSS vs WAAPI vs requestAnimationFrame, Motion's hardware-accelerated path, React re-rendering per frame, inherited CSS variable recalculation, blur cost, and when will-change actually helps. Use when an animation is janky, choppy, stutters, or d

1h installs
2
GitHub stars
13
Updated
Nov 5