impeccable

name	impeccable
description	Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.
version	3.0.4
user-invocable	true
argument-hint	[craft|shape · audit|critique · animate|bolder|colorize|delight|layout|overdrive|quieter|typeset · adapt|clarify|distill · harden|onboard|optimize|polish · teach|document|extract|live] [target]
license	Apache 2.0. Based on Anthropic's frontend-design skill. See NOTICE.md for attribution.
allowed-tools	["Bash(npx impeccable *)"]

Designs and iterates production-grade frontend interfaces. Real working code, committed design choices, exceptional craft.

Setup (non-optional)

Before any design work or file edits, pass these gates. Skipping them produces generic output that ignores the project.

Gate	Required check	If fail
Context	The PRODUCT.md / DESIGN.md loader result is known from node .claude/skills/impeccable/scripts/load-context.mjs.	Run the loader before continuing.
Product	PRODUCT.md exists and is not empty or placeholder ([TODO] markers, <200 chars).	Run /impeccable teach, refresh context, then resume. Never synthesize PRODUCT.md from the user's original prompt alone.
Command	The matching command reference is loaded when a sub-command is used.	Load the reference before continuing.
Craft	/impeccable craft has a user-confirmed shape brief for this task. teach / PRODUCT.md never counts as shape.	Run /impeccable shape and wait for explicit brief confirmation.
Image	Required visual probes / mocks are generated or skipped with a reason.	Resolve the image-generation gate in shape.md or craft.md before code.
Mutation	All active gates above pass.	Do not edit project files yet.

Codex-style agents must state this before editing files:

IMPECCABLE_PREFLIGHT: context=pass product=pass command_reference=pass shape=pass|not_required image_gate=pass|skipped:<reason> mutation=open

For /impeccable craft, shape=pass is only valid after a separate user response approving the shape design brief, or when the user provided an already-confirmed brief in the request. Do not mark shape=pass after writing PRODUCT.md, summarizing assumptions, or drafting an unconfirmed brief yourself.

Other harnesses should follow the same checklist when they can expose this state.

1. Context gathering

Two files at the project root, case-insensitive:

• PRODUCT.md — required. Users, brand, tone, anti-references, strategic principles.
• — optional, strongly recommended. Colors, typography, elevation, components.