skills.rest
burningportra
burningportraCOMMUNITY
Explore all skills by this author →
GitHub

ui-ux-polish

Generates numbered UI/UX improvement suggestions and converts selected items into implementation beads.

3|1|Updated Apr 15, 2026
Search Tags:#accessibility#implementation#beads#user experience#design review#polish#ui ux
One-click install
npx skills add https://github.com/burningportra/agent-flywheel-plugin --skill ui-ux-polish-burningportra
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ui-ux-polish
Source: https://github.com/burningportra/agent-flywheel-plugin/tree/main/skills/ui-ux-polish
Command: npx skills add https://github.com/burningportra/agent-flywheel-plugin --skill ui-ux-polish-burningportra

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After initial implementation, interfaces often ship with rough edges and no structured process exists to systematically identify, prioritize, and implement UI/UX refinements. ## Core Features & Use Cases - Scrutiny Agent: Spawns a sub-agent that produces 15-30 numbered improvement suggestions covering user-friendliness, visual polish, and desktop/mobile-specific optimizations. - Selection and Bead Conversion: Presents suggestions for user selection by number, category, or all, then converts each choice into a bead with acceptance criteria and file references via br create. - Automated Implementation: Triggers swarm-based implementation through flywheel_approve_beads and finishes with a de-slopification pass on modified documentation and UI copy. - Use Case: After building a dashboard, run this skill to get a prioritized list of polish items like spacing fixes and accessibility improvements, pick the ones you want, and have them implemented automatically. ## Quick Start Run a UI/UX polish pass on the implemented application and present the improvement suggestions for my selection.

Frequently Asked Questions about ui-ux-polish

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

FAQPage Schema
How do I run a UI/UX polish pass on implemented code?▼

Invoke the skill after initial implementation is complete. It spawns a scrutiny agent that produces 15-30 numbered improvement suggestions, which you select by number, category, or all before they are converted to beads and implemented.

How are UI/UX suggestions turned into implementation tasks?▼

Each selected suggestion is converted into a bead via `br create` with a concise title, the full suggestion as description, acceptance criteria, and a Files section. The skill then calls `flywheel_approve_beads` to launch swarm implementation.

Can I get deeper suggestions for desktop and mobile separately?▼

Yes, a second-round follow-up prompt instructs the scrutiny agent to consider desktop UI/UX and mobile UI/UX separately and hyper-optimize for each modality's specifics.

When should I not use this polish workflow?▼

Do not use it before initial implementation is complete, since it assumes working code exists to scrutinize. It is also not suited for functional bug fixing, as it targets user-friendliness, visual polish, and UX improvements.

What happens to documentation after UI changes are implemented?▼

A de-slopification pass runs on any documentation or UI copy files modified during implementation, removing AI writing patterns and improving documentation tone.

Related Skills

Explore More Design & Creative Skills→
TitoPrauseeTitoPrausee

codex

Delegate coding tasks to the Codex CLI agent in a git repository.

Community
Advanced
vega113vega113

beads-integrator

Merge Beads task branches into the base branch with serialized metadata recording.

Community
Advanced
baphledbaphled
1

accessibility

Implement WCAG principles, keyboard navigation, and screen reader support in terminal applications.

Community
Intermediate
rp4rirp4ri

design-critique

Evaluate Figma screens against UX heuristics using the Figma API and Python libraries.

Community
Advanced