polish-ui

Enforces UI interaction requirements for buttons and focus-trapping components in .tsx/.jsx files.

121|2|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/AgentSystemLabs/core --skill polish-ui
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polish-ui
Source: https://github.com/AgentSystemLabs/core/tree/main/plugins/agentsystem-core/skills/polish-ui
Command: npx skills add https://github.com/AgentSystemLabs/core --skill polish-ui

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents UX polish regressions by checking and correcting keyboard shortcuts, modal dismissal behavior, and related interaction details in the same edit where the UI change is introduced.

Core Features & Use Cases

  • Action shortcut visibility: Ensures keyboard shortcuts appear in visible button labels (with platform-appropriate glyphs) and that the shortcut is actually wired to the action.
  • Escape-to-close for focus-trapping UI: Verifies dialogs, modals, sheets, drawers, and popovers close on Esc and return focus to the trigger after closing.
  • Change-aware evaluation: Applies only to items that match the specific UI change (e.g., adding/editing a button, wiring a form submit, or building a dialog), and skips non-applicable edits like backend-only or type-only refactors.

Quick Start

Ask the AI to run the polish-ui checklist on your UI change and apply any missing fixes inline before you report the work as done.

Frequently Asked Questions about polish-ui

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

FAQPage Schema
How do I ensure modals close on Escape and return focus to the trigger button?

To ensure modals close on Escape and return focus, evaluate focus-trapping components like dialogs and popovers against an interaction checklist, verifying that the Escape key reliably dismisses the UI and restores focus to the trigger element inline.

How do I verify keyboard shortcuts are wired to button actions in React?

Verify keyboard shortcuts in React by checking that visible button labels display platform-appropriate glyphs and confirming the shortcut binding actually triggers the corresponding action within the same UI edit cycle.

What is UX polish regression in frontend development?

UX polish regression in frontend development occurs when new UI changes introduce gaps in interaction details, such as missing keyboard shortcut visibility or broken modal dismissal behavior, which a change-scoped evaluation checks and corrects.

Does this UI checklist evaluation work with backend-only refactors?

This UI checklist evaluation does not work with backend-only refactors. It applies change-aware scoping to skip non-applicable edits and only evaluates items involving actions like buttons, modals, forms, and keyboard-driven interactions in .tsx/.jsx files.

What is the best way to fix UX gaps when adding a new button or dialog?

The best way to fix UX gaps when adding a new button or dialog is to run a checklist-driven evaluation that enforces interaction requirements and applies inline corrections for shortcuts and focus-trapping behavior in the same turn.