polish

Overview

What is the polish Skill?

The polish skill is designed for UI designers and frontend developers who want to elevate their interface from functional to exceptional. It focuses on a meticulous final quality pass, addressing alignment, spacing, consistency, and micro-detail issues before shipping. This skill is ideal when you need finishing touches, a pre-launch review, or want to resolve subtle visual and interaction flaws that make a product feel truly polished.

Who Should Use polish?

• UI designers seeking pixel-perfect results
• Frontend engineers working with React or similar frameworks
• Teams preparing for a flagship release or raising their quality bar
• Anyone noticing "something looks off" or aiming to go from good to great

Problems Solved

• Visual inconsistencies and misalignment
• Spacing and grid issues
• Interaction state gaps and edge cases
• Copy and content inconsistencies
• Loading and transition smoothness

How to Use

Installation Steps

1. Install the polish skill using:
   npx skills add https://github.com/pbakaus/impeccable --skill polish
2. Begin with the SKILL.md file for workflow guidance.
3. Review supporting files such as README.md, AGENTS.md, and metadata.json for context and best practices.

Preparation Checklist

• Invoke $frontend-design for design principles and context gathering.
• If no design context exists, run $teach-impeccable first.
• Determine your quality bar (MVP vs flagship) and shipping timeline.

Applying the Workflow

• Conduct a pre-polish assessment: ensure functional completeness, identify areas needing polish, and mark known issues.
• Systematically address visual alignment, spacing, interaction states, copy, edge cases, and transitions.
• Use the spacing scale and grid for pixel-perfect results.
• Polish is only effective as the final step—do not apply to incomplete work.

File Structure Guidance

• Start with SKILL.md for step-by-step instructions.
• Explore additional folders like rules/, resources/, and references/ for advanced tips.

FAQ

Is polish suitable for early-stage projects?

No. The polish skill is intended for final quality passes on functionally complete work. Use it when preparing for launch or raising the quality bar.

Can polish be used with any frontend framework?

While optimized for React and modern frontend workflows, the principles apply broadly to UI design and frontend development.

Where can I find detailed workflow instructions?

All guidance is in SKILL.md and related files. Open the Files tab to review the full file tree, including references and helper scripts.

What if my project lacks design context?

Run $teach-impeccable to establish baseline design context before applying polish.

How does polish improve my UI?

By systematically fixing alignment, spacing, and micro-details, polish ensures your interface feels cohesive, professional, and ready for users.