polish

Overview

What is the polish Skill?

The polish skill is designed for UI designers and frontend developers who want to deliver a visually refined product. It focuses on the final quality pass—fixing alignment, spacing, consistency, and micro-detail issues that can make the difference between a good interface and a great one. Use polish when you need finishing touches, a pre-launch review, or when something in the UI feels slightly off.

Who Should Use polish?

• UI/UX designers preparing for handoff or launch
• Frontend developers finalizing features
• Teams aiming for high-quality, professional interfaces

Problems polish Solves

• Inconsistent spacing and alignment
• Visual and interaction state gaps
• Copy and microcopy inconsistencies
• Missed edge cases and error states
• Unpolished loading and transition behaviors

How to Use

Installation Steps

1. Install the skill using the following command:

   npx skills add https://github.com/pbakaus/impeccable --skill polish

2. Start by reviewing the SKILL.md file for the full workflow and checklist.

3. For additional context, check related files such as README.md, AGENTS.md, and any supporting folders like rules/ or resources/ if present.

Workflow Guidance

• Mandatory Preparation: Before using polish, ensure the UI is functionally complete. Run the /frontend-design skill to gather design context and standards. If no context exists, use /teach-impeccable first.
• Pre-Polish Assessment: Review the current UI for completeness, known issues, and the quality bar (MVP vs flagship). Identify areas needing polish, such as visual inconsistencies or interaction gaps.
• Systematic Polish: Methodically address alignment, spacing, consistency, copy, edge cases, and transitions. Use a spacing scale and grid alignment for pixel-perfect results.

When to Use polish

• During final QA before launch
• When stakeholders request a "final touch" or "something looks off"
• To elevate MVPs to flagship quality

FAQ

What does polish actually do?

polish guides you through a detailed checklist to fix visual and interaction details, ensuring your UI meets a high-quality standard before shipping.

When should I run polish?

Only after the UI is functionally complete. Polish is not for early-stage or incomplete work.

Where can I find the workflow steps?

All steps and checklists are in the SKILL.md file. Start there for a structured approach.

Is polish suitable for all frontend projects?

polish is best for projects where visual quality matters—especially production UIs, design systems, and flagship features. For rapid prototypes, it may be less critical.

How do I adapt polish to my project?

Review the workflow and adapt the checklists to your team's standards, tools, and timelines. Use the skill as a guide, not a rigid rulebook.