polish

Overview

What is the Polish Skill?

The polish skill is designed for UI designers and frontend teams who want to deliver visually impeccable products. It provides a structured workflow for performing a final quality pass, targeting alignment, spacing, consistency, and micro-detail issues that often go unnoticed until the last minute. Use the polish skill when you need to add finishing touches, conduct a pre-launch review, or address feedback that something "looks off."

Who Should Use Polish?

• UI/UX designers preparing for product launch
• Frontend developers focused on design quality
• Teams aiming to move from MVP to flagship-level polish

Problems Solved

• Inconsistent alignment and spacing
• Visual and copy inconsistencies
• Overlooked interaction states and edge cases
• Last-mile design issues that impact perceived quality

How to Use

Installation Steps

1. Add the Skill:
   Install the polish skill using the following command:

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

2. Review Key Files:

   • Start with SKILL.md for the workflow overview.
   • Reference README.md, AGENTS.md, and metadata.json for additional context.
   • Explore any rules/, resources/, references/, or scripts/ folders for supporting materials.

3. Prepare Your Context:

   • Invoke /frontend-design to gather design principles and context.
   • If no design context exists, run /teach-impeccable first.
   • Clarify your quality bar (MVP vs flagship) and timeline.

Workflow Overview

• Pre-Polish Assessment:
  • Confirm functional completeness.
  • Identify known issues and polish areas (visual, copy, interaction, edge cases).
• Systematic Polish:
  • Address pixel-perfect alignment and consistent spacing.
  • Review interaction states, copy, and transitions.
  • Ensure all visual and micro-detail issues are resolved.

When to Use (and Not Use)

• Use polish as the final step before shipping, not during early development.
• Do not apply polish to incomplete or unstable work.

FAQ

What does the polish skill actually do?

Polish provides a checklist-driven workflow to catch and fix the small UI issues that elevate a product's perceived quality. It focuses on alignment, spacing, consistency, and micro-details.

Is polish only for designers?

While primarily aimed at UI/UX designers, frontend developers and product teams can also use polish to ensure a visually consistent and professional release.

How do I know if I need polish?

If your product is functionally complete but lacks visual refinement, or if stakeholders mention "finishing touches" or "something looks off," it's time to use polish.

Where can I find more details?

Open the Files tab in the repository to explore the full file tree, including SKILL.md and any supporting scripts or references.