polish-ui

Validate keyboard shortcut labels and Esc-to-close behavior in .tsx/.jsx UI components.

22|3|Updated Jul 28, 2024
One-click install
npx skills add https://github.com/webdevcody/go-mailing-list --skill polish-ui-webdevcody
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polish-ui
Source: https://github.com/webdevcody/go-mailing-list/tree/main/.claude/skills/polish-ui
Command: npx skills add https://github.com/webdevcody/go-mailing-list --skill polish-ui-webdevcody

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents UI changes from shipping with subtle usability gaps like missing visible keyboard shortcuts or dialogs that don’t reliably close on Escape.

Core Features & Use Cases

  • Keyboard-shortcut visibility: Ensures action buttons that have (or should have) shortcuts display the correct glyphs in the visible label and that the shortcut is actually wired.
  • Esc-to-close compliance: Verifies modals, dialogs, sheets, drawers, popovers, and other attention-trapping surfaces close on Esc and return focus appropriately.
  • Targeted, change-specific fixing: Applies only to the UI interactions introduced or edited in the current .tsx/.jsx changes, skipping backend-only or interaction-neutral edits.

Quick Start

Run the polish-ui skill on the specific UI change and have it check the updated .tsx/.jsx files, then fix any applicable shortcut/close-on-Esc gaps inline.

Frequently Asked Questions about polish-ui

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

FAQPage Schema
How do I ensure my React dialogs and modals close on Escape key?

To ensure React dialogs close on Escape, you must verify key handlers are actually bound to the interactive surface. Esc-to-close compliance also requires returning focus appropriately to the triggering element after dismissing modals, sheets, drawers, or popovers.

What is the best way to check keyboard shortcuts are visible and wired in .tsx files?

Checking keyboard shortcut visibility in .tsx files involves validating that action buttons display the correct platform-aware glyphs in the visible label. The UI validation process also confirms the shortcut key handler is actually bound to the button's action.

Does this UI polish workflow apply to backend-only changes in my frontend project?

This UI polish workflow does not apply to backend-only or interaction-neutral code changes. It specifically targets user interaction changes in .tsx or .jsx files, skipping edits that do not introduce new interactive surfaces like dialogs, command palettes, or buttons.

How do I add accessibility UX checks for newly added command palettes and popovers?

Adding accessibility UX checks for command palettes and popovers requires verifying Esc dismissal behavior and correct focus return for attention-trapping UI primitives. You apply these checks only to the newly edited components to ensure keyboard-driven actions meet core accessibility expectations.

Why do my keyboard-driven action buttons need platform-aware shortcut rendering?

Keyboard-driven action buttons need platform-aware shortcut rendering to display the correct glyphs for different operating systems. This ensures keyboard users see the accurate visible shortcut label and that the displayed shortcut matches the actually bound key handler.