polish

Fix alignment, spacing, interaction states, and accessibility in UI implementations.

Updated Jul 5, 2025
One-click install
npx skills add https://github.com/nsuberi/proto-portal-showcase-hub --skill polish-nsuberi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polish
Source: https://github.com/nsuberi/proto-portal-showcase-hub/tree/main/apps/ai-builders-portal/.claude/skills/polish
Command: npx skills add https://github.com/nsuberi/proto-portal-showcase-hub --skill polish-nsuberi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill closes the gap between functionally complete features and ship-ready user experiences by identifying and correcting alignment, spacing, interaction, accessibility, copy, and micro-detail issues that undermine perceived quality.

Core Features & Use Cases

  • Pre-Polish Assessment: Evaluate completeness, quality bar (MVP vs flagship), shipping timeline, and known issues to avoid polishing incomplete work.
  • Systematic Visual Audit: Enforce pixel alignment, consistent spacing tokens, optical alignment, typography hierarchy, and responsive grid adherence.
  • Interaction & Motion: Verify all interaction states, smooth transitions at 60fps, consistent easing, and respects prefers-reduced-motion.
  • Content & Accessibility: Standardize copy, capitalization, alt text, WCAG contrast, focus indicators, and keyboard navigation.
  • Assets, Forms & Performance: Ensure icons/images sizing and retina support, labeled inputs and validation, optimized images, and no layout shift.
  • Code Quality & Final Verification: Remove debug logs, commented dead code, enforce type safety, test on real devices, and run cross-browser checks.
  • Use Case: Run as the last step before release to convert a functioning prototype into a polished, accessible, and production-ready feature.

Quick Start

Use the polish skill to perform a final quality pass focusing on alignment, spacing, interaction states, accessibility, and performance before marking a feature as done.

Frequently Asked Questions about polish

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

FAQPage Schema
How do I make my UI prototype visually polished and production-ready before shipping?

To make a UI prototype visually polished and production-ready, run a final quality pass that fixes pixel alignment, enforces spacing tokens, verifies all interaction states, and removes debug code artifacts.

What is included in a front-end visual audit for spacing and typography consistency?

A front-end visual audit enforces pixel alignment, consistent spacing token usage, optical alignment, typography hierarchy, and responsive grid adherence to ensure design quality before release.

How do I check WCAG contrast and accessibility compliance for my UI components?

To check WCAG contrast and accessibility compliance, audit UI components for color contrast ratios, focus indicators, keyboard navigation, alt text, and proper labeled form inputs.

Does this UI polish process work on existing feature releases or only new prototypes?

The UI polish process applies to prototypes, feature releases, and UI components. It first assesses completeness and the quality bar to avoid polishing incomplete work before applying fixes.

What's the best way to ensure smooth 60fps transitions and motion in front-end interactions?

To ensure smooth 60fps transitions, verify all interaction states, apply consistent easing, respect prefers-reduced-motion settings, and check that transitions avoid layout shift.

When should I avoid running a UI polish and design quality pass?

Avoid running a UI polish pass when the feature is functionally incomplete. The process first evaluates completeness, known issues, and shipping timeline to avoid polishing unfinished work.