Impeccable
Paul BakausCommunityCreated by Paul Bakaus
- Skill
- Workflow
- Design and creative
- Apache-2.0
- Low risk
- Has scripts
AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
Impeccable provides a structured approach to designing, auditing, and refining frontend interfaces including websites, dashboards, and mobile applications. It operates by establishing product context through documentation and applying specific design modes—Persuade, Operate, Read, and Experience—to guide the visual and functional direction of a project. The skill supports a wide range of tasks from initial planning and documentation to technical audits, visual refinements, and animation, ensuring that design changes remain consistent with the established visual world.
What it does
- Audits UI for accessibility, performance, and responsive behavior.
- Generates design documentation from existing project code.
- Refines visual elements through commands like colorize, typeset, and layout.
- Provides tools to plan UX and UI before implementation.
- Manages design system tokens and component extraction.
- Supports iterative design through live variant generation and testing.
When to use it
- When you need to perform a UX critique or technical audit of an existing interface.
- When starting a new design surface or defining a new visual world.
- When you need to polish or refine UI components before a release.
- When you need to adapt an interface for different screen sizes or platforms.
- When you need to add purposeful animations or improve typography hierarchy.
Advantages
- Provides a consistent framework for design decisions across different project types.
- Integrates technical audits directly into the design workflow.
- Supports specific modes to align design output with user intent.
- Enables structured documentation of product and design context.
- Offers granular control over UI refinements through specialized commands.
Usage examples
- “impeccable audit src/components/Dashboard.tsx”
- The agent performs a technical quality check on the dashboard component, reporting on accessibility, performance, and responsiveness.
- “impeccable polish src/landing-page.css”
- The agent executes a final quality pass on the landing page styles to ensure visual consistency and adherence to the design system.
- “impeccable animate hero-section”
- The agent applies purposeful motion and animation to the specified hero section based on the project's design mode.
- “impeccable init”
- The agent captures the current project context and creates a PRODUCT.md file to serve as the foundation for future design work.
Install
Download the skill as a ZIP:
https://autogineer.com/agent-skills/pbakaus/impeccable/downloadUnzip it into the cross-client skills folder of your project:
mkdir -p .agents/skills && unzip impeccable.zip -d .agents/skills
Documentation by Paul Bakaus
This skill gives you the tools and permission to make design that earns the name out-of-distribution craft. Work as an award-winning design director would: production-grade code, a clear POV, a deep grasp of what the client and its users need, and exceptional craft.
Core principles:
Finish the job. No hedging, no shortcuts: the deliverable is complete, except assets the user must provide.
Scale ambition to the surface's mode (see Modes). Persuade and Experience get full commitment: bold, distinct work with a point of view. On Operate and Read, ambition shows as precision and restraint, and patterns the visitor already knows earn their place.
Verify by looking at the rendered result at the sizes it ships at, and batch the checks: fix what one look shows before looking again, rather than screenshotting after every tweak.
Setup
Run
"${CLAUDE_SKILL_DIR}/scripts/impeccable" contextonce per session, where${CLAUDE_SKILL_DIR}is the directory that contains this SKILL.md (the skill folder, not a plugin root two levels above it); keep cwd at the user's project. Every"${CLAUDE_SKILL_DIR}/scripts/impeccable" <verb>command in this skill and its references resolves against that base directory. In reference files, replace the skill-base-dir placeholder with this directory before running commands; it is not a shell variable. On a Windows shell withoutsh, call& "${CLAUDE_SKILL_DIR}/scripts/impeccable.cmd"instead. The launcher runs a self-contained binary that ships next to it or is downloaded once on first run; no Node or other runtime is required. Pass a named source file or route as--target <path>. It loads PRODUCT.md, DESIGN.md, the matching surface brief, and native-platform guidance when applicable; follow its directives and do not rerun it.Load the request's playbook: its Commands-table reference for an explicit/implied sub-command, or reference/new-work.md for a new surface or replacement visual world. Inspect target and incumbent visual truth before editing. When the app cannot run, start with committed visual-regression goldens or screenshot fixtures; verify target and freshness against current tokens, CSS, components, or assets, resolve conflicts, and compare theme/variant captures.
After resolving analysis and direction, read reference/craft-floor.md immediately before any UI edit, including small refinements. It carries the quality floor, the absolute bans, and the reflexes no detector catches. Do not load it for planning-only work.
Launcher unavailable: On refusal or failure, send a separate message before the next tool call: “Context loading did not run; I’ll read the existing project context directly.” Then read existing PRODUCT.md and DESIGN.md without inventing missing context, follow applicable steps 2–3, including reading reference/craft-floor.md immediately before any UI edit, and continue through permitted tools. This applies to planning and editing; launcher failure alone does not block either.
How to design
The brief wins. Honor pinned aesthetics, eras, materials, fonts, and palettes even when they conflict with a saturated-pattern warning. Redirecting a clear brief toward your taste is failure.
Refinement preserves; redesign replaces. Refinement keeps the incumbent identity, behavior, copy, and everything outside scope. Ask before replacing factual copy or adding claims. Redesign keeps product truth, content, function, native affordances, and constraints, but treats the old look as evidence and anti-reference; choose a replacement world in new-work and replace DESIGN.md. Never split the difference into polish on the discarded look.
Loaded symbols stay out of the decoration. A subject's world does not license emblems tied to militarism, supremacy, or hate movements as motifs, badges, or ornament, such as the Rising Sun flag's rays, the Confederate battle flag, or Nazi-era insignia and their stylised variants; reach for that world's neutral forms instead. Content that documents such a symbol as fact stays as it is.
Visual authority is evidence, not a filename. Missing DESIGN.md alone does not make a project greenfield; new-work decides whether to preserve, expand, or replace the incumbent world.
Modes
The mode names what the visitor's success looks like on this surface.
Persuade: the visitor decides and acts; design is the product. Landing pages, marketing, campaigns, pricing. Earn attention and action. Ship real imagery when the brief needs it; follow the committed world, not category habit.
Operate: the visitor completes a task. App UI, dashboards, editors, admin, settings, tools. Scanability, consistency, native expectations, and the real usage scene outrank expression. Brand lives in precise details.
Read: the visitor understands something. Docs, articles, guides, help, changelogs. Structure for comprehension, then make the reading experience worth staying in.
Experience: the visitor is inside the work itself. Portfolios, galleries, showcases. Let the artifact lead from the first viewport; the interface recedes.
Choose the mode from the requested surface, not the product, and persist it only in that surface brief. A tool's landing page is still Persuade; a fashion house's documentation is still Read; a docs index is Read, not Persuade. See new-work.md for new surfaces and operate.md for deeper Operate/Read guidance.
Commands
| Command | Category | Description | Reference |
|---|---|---|---|
craft [feature] | Build | Deprecated alias for an ordinary new-work request | reference/craft.md |
shape [feature] | Build | Plan UX/UI before writing code | reference/shape.md |
init | Build | Capture durable product context in PRODUCT.md | reference/init.md |
document | Build | Generate DESIGN.md from existing project code | reference/document.md |
extract [target] | Build | Pull reusable tokens and components into design system | reference/extract.md |
critique [target] | Evaluate | UX design review with heuristic scoring | reference/critique.md |
audit [target] | Evaluate | Technical quality checks (a11y, perf, responsive) | reference/audit.md · native: reference/audit.native.md |
polish [target] | Refine | Final quality pass before shipping | reference/polish.md |
bolder [target] | Refine | Amplify safe or bland designs | reference/bolder.md |
quieter [target] | Refine | Tone down aggressive or overstimulating designs | reference/quieter.md |
distill [target] | Refine | Strip to essence, remove complexity | reference/distill.md |
harden [target] | Refine | Production-ready: errors, i18n, edge cases | reference/harden.md |
onboard [target] | Refine | Design first-run flows, empty states, activation | reference/onboard.md |
animate [target] | Enhance | Add purposeful animations and motion | reference/animate.md |
colorize [target] | Enhance | Add strategic color to monochromatic UIs | reference/colorize.md |
typeset [target] | Enhance | Improve typography hierarchy and fonts | reference/typeset.md |
layout [target] | Enhance | Fix spacing, rhythm, and visual hierarchy | reference/layout.md |
delight [target] | Enhance | Add personality and memorable touches | reference/delight.md |
overdrive [target] | Enhance | Push past conventional limits | reference/overdrive.md |
clarify [target] | Fix | Improve UX copy, labels, and error messages | reference/clarify.md |
adapt [target] | Fix | Adapt for different devices and screen sizes | reference/adapt.md · native: reference/adapt.native.md |
optimize [target] | Fix | Diagnose and fix UI performance | reference/optimize.md |
live | Iterate | Visual variant mode: pick elements in the browser, iterate on alternatives | reference/live.md |
generate [n] [action] [element] | Iterate | Variants, versions, or alternatives of a named element to choose from in the live browser; no manual picking | reference/generate.md |
Routing:
No argument: read routing.md and present its context-aware menu; never auto-run a command.
Explicit or clearly implied request to run a command: load its reference (native variant on native platforms) and follow it. Ask once if two commands fit.
Workflow or command-selection question: read Workflow questions.
Otherwise: treat the request as general design work. Missing PRODUCT.md routes a new surface or replacement world through init, then new-work; a narrow refinement of existing code proceeds on the incumbent implementation as
impeccable contextdirects, offering init afterward rather than blocking on it.teachaliasesinit.craftis a deprecated alias for ordinary new-work and adds nothing.shapeowns task discovery, then enters new-work only for visual-world and surface-concept decisions.
After init writes PRODUCT.md, resume without rerunning impeccable context; init loads the native platform reference itself when the platform it recorded is ios, android, or adaptive.
Pin / Unpin: "${CLAUDE_SKILL_DIR}/scripts/impeccable" pin <pin|unpin> <command> creates or removes a standalone /<command> shortcut. Report the script's result concisely; relay stderr verbatim on error.
Hooks: /impeccable hooks <on|off|status|ignore-rule|ignore-file|ignore-value|reset> manages the design detector hook for this project (auto-runs the detector after UI file edits and surfaces findings). Load reference/hooks.md when the user invokes it with any argument.
Doctor: /impeccable doctor reports and repairs drift between this project's Impeccable artifacts (PRODUCT.md, DESIGN.md and its sidecar, config, surface briefs, the hook) and what this version reads. Load reference/doctor.md when the user invokes it, or when they ask what is out of date, stale, or needs refreshing. A CONTEXT_STALE directive in Setup's output is the cheap subset of the same report; act on it there per its own instructions rather than running doctor unasked.
Never repair drift as a side effect of a design task. A CONTEXT_STALE finding is reported, not acted on, unless the user asks. The one exception is a finding marked auto, which the next write to that file performs anyway.
Files
- ATTRIBUTION.mdAdded by AutoGineer866 B
- LICENSELicence file added by AutoGineer10.5 KiB
- NOTICELicence file added by AutoGineer503 B
- SKILL.md11.4 KiB
- reference/adapt.md11.0 KiB
- reference/adapt.native.md3.8 KiB
- reference/android.md4.1 KiB
- reference/animate.md5.1 KiB
- reference/audit.md9.4 KiB
- reference/audit.native.md8.1 KiB
- reference/bolder.md3.4 KiB
- reference/clarify.md4.5 KiB
- reference/colorize.md4.4 KiB
- reference/component-review.md7.8 KiB
- reference/craft-floor.md4.4 KiB
- reference/craft.md555 B
- reference/critique.md44.5 KiB
- reference/degraded/asset-producer.md8.3 KiB
- reference/degraded/documenter.md3.6 KiB
- reference/degraded/finish-reviewer.md15.5 KiB
- reference/degraded/manual-edit-applier.md7.5 KiB
- reference/delight.md3.6 KiB
- reference/distill.md5.4 KiB
- reference/doctor.md5.5 KiB
- reference/document.md26.8 KiB
- reference/extract.md3.3 KiB
- reference/generate.md12.8 KiB
- reference/harden.md10.5 KiB
- reference/hooks.md16.9 KiB
- reference/init.md11.9 KiB
- reference/ios.md3.7 KiB
- reference/layout.md5.0 KiB
- reference/live-setup.md8.0 KiB
- reference/live.md36.4 KiB
- reference/mode-operate.md4.6 KiB
- reference/mode-persuade.md3.6 KiB
- reference/mode-read.md4.3 KiB
- reference/new-work.md62.0 KiB
- reference/onboard.md7.5 KiB
- reference/operate.md4.0 KiB
- reference/optimize.md7.4 KiB
- reference/overdrive.md8.8 KiB
- reference/polish.md6.5 KiB
- reference/quieter.md4.8 KiB
- reference/region-map.md3.3 KiB
- reference/routing.md3.2 KiB
- reference/shape.md3.5 KiB
- reference/typeset.md6.1 KiB
- reference/visualize.md13.6 KiB
- scripts/VERSION7 B
- scripts/command-metadata.json8.1 KiB
- scripts/data/font-index-failures.json2.4 KiB
- scripts/data/font-index.json1.0 MiB
- scripts/engine-checksums.txt787 B
- scripts/impeccableScript11.1 KiB
- scripts/impeccable.cmdScript11.9 KiB
- scripts/live-browser-dom.jsScript12.0 KiB
- scripts/live-browser-ignores.jsScript10.2 KiB
- scripts/live-browser-session.jsScript5.7 KiB
- scripts/live-browser.jsScript550.0 KiB
- scripts/modern-screenshot.umd.jsScript28.6 KiB
reference/overdrive.md
Start your response with:
──────────── ⚡ OVERDRIVE ─────────────
》》》 Entering overdrive mode...Push an interface past conventional limits. This isn't just about visual effects. It's about using the full power of the browser to make any part of an interface feel extraordinary: a table that handles a million rows, a dialog that morphs from its trigger, a form that validates in real-time with streaming feedback, a page transition that feels cinematic.
Context decides what "extraordinary" means. A particle system on a creative portfolio is impressive. The same particle system on a settings page is embarrassing. But a settings page with instant optimistic saves and animated state transitions? That's extraordinary too. Understand the project's personality and goals before deciding what's appropriate.
Propose Before Building
This command has the highest potential to misfire. Do NOT jump straight into implementation. You MUST:
Think through 2-3 different directions: consider different techniques, levels of ambition, and aesthetic approaches. For each direction, briefly describe what the result would look and feel like.
Get the user's pick before writing any code. Ask with the AskUserQuestion tool and wait for the answer before continuing. Carry each direction's description and its trade-offs (browser support, performance cost, complexity) inside the option itself, so the user is choosing between things they can read. A structured question blocks the message it rides in until the user answers, so directions written alongside the question stay invisible while the user is being asked to choose between them.
Only proceed with the direction the user confirms.
Skipping this step risks building something embarrassing that needs to be thrown away.
Verify in the Browser
Ambitious effects rarely work on the first try, so verify them in the browser rather than from code: an effect that technically runs can still stutter, ease wrong, or land on the wrong frame. Aim the checks at timing, easing, and smoothness, batch the fixes between looks, and keep refining until the effect is extraordinary.
Assess What "Extraordinary" Means Here
The right kind of technical ambition depends entirely on what you're working with. Before choosing a technique, ask: what would make a user of THIS specific interface say "wow, that's nice"?
For visual/marketing surfaces
Pages, hero sections, landing pages, portfolios: the "wow" is often sensory: a scroll-driven reveal, a shader background, a cinematic page transition, generative art that responds to the cursor.
For functional UI
Tables, forms, dialogs, navigation: the "wow" is in how it FEELS: a dialog that morphs from the button that triggered it via View Transitions, a data table that renders 100k rows at 60fps via virtual scrolling, a form with streaming validation that feels instant, drag-and-drop with spring physics.
For performance-critical UI
The "wow" is invisible but felt: a search that filters 50k items without a flicker, a complex form that never blocks the main thread, an image editor that processes in near-real-time. The interface just never hesitates.
For data-heavy interfaces
Charts and dashboards: the "wow" is in fluidity: GPU-accelerated rendering via Canvas/WebGL for massive datasets, animated transitions between data states, force-directed graph layouts that settle naturally.
The common thread: something about the implementation goes beyond what users expect from a web interface. The technique serves the experience, not the other way around.
The Toolkit
Organized by what you're trying to achieve, not by technology name.
Make transitions feel cinematic
View Transitions API (same-document: all browsers; cross-document: no Firefox): shared element morphing between states. A list item expanding into a detail page. A button morphing into a dialog. This is the closest thing to native FLIP animations.
@starting-style(all browsers): animate elements fromdisplay: noneto visible with CSS only, including entry keyframesSpring physics: natural motion with mass, tension, and damping instead of cubic-bezier. Libraries: motion (formerly Framer Motion), GSAP, or roll your own spring solver.
Tie animation to scroll position
Scroll-driven animations (
animation-timeline: scroll()): CSS-only, no JS. Parallax, progress bars, reveal sequences all driven by scroll position. (Chrome/Edge/Safari; Firefox: flag only; always provide a static fallback)
Render beyond CSS
WebGL (all browsers): shader effects, post-processing, particle systems. Libraries: Three.js, OGL (lightweight), regl. Use for effects CSS can't express.
WebGPU (Chrome/Edge; Safari 26+; Firefox on Windows/macOS; flag only on Firefox Linux/Android): next-gen GPU compute, more powerful than WebGL. Always fall back to WebGL2.
Canvas 2D / OffscreenCanvas: custom rendering, pixel manipulation, or moving heavy rendering off the main thread entirely via Web Workers + OffscreenCanvas.
SVG filter chains: displacement maps, turbulence, morphology for organic distortion effects. CSS-animatable.
Make data feel alive
Virtual scrolling: render only visible rows for tables/lists with tens of thousands of items. No library required for simple cases; TanStack Virtual for complex ones.
GPU-accelerated charts: Canvas or WebGL-rendered data visualization for datasets too large for SVG/DOM. Libraries: deck.gl, regl-based custom renderers.
Animated data transitions: morph between chart states rather than replacing. D3's
transition()or View Transitions for DOM-based charts.
Animate complex properties
@property(all browsers): register custom CSS properties with types, enabling animation of gradients, colors, and complex values that CSS can't normally interpolate.Web Animations API (all browsers): JavaScript-driven animations with the performance of CSS. Composable, cancellable, reversible. The foundation for complex choreography.
Push performance boundaries
Web Workers: move computation off the main thread. Heavy data processing, image manipulation, search indexing: anything that would cause jank.
OffscreenCanvas: render in a Worker thread. The main thread stays free while complex visuals render in the background.
WASM: near-native performance for computation-heavy features. Image processing, physics simulations, codecs.
Interact with the device
Web Audio API: spatial audio, audio-reactive visualizations, sonic feedback. Requires user gesture to start.
Device APIs: orientation, ambient light, geolocation. Use sparingly and always with user permission.
NOTE: This command is about enhancing how an interface FEELS, not changing what a product DOES. Adding real-time collaboration, offline support, or new backend capabilities are product decisions, not UI enhancements. Focus on making existing features feel extraordinary.
Implement with Discipline
Progressive enhancement is non-negotiable
Every technique must degrade gracefully. The experience without the enhancement must still be good.
@supports (animation-timeline: scroll()) {
.hero { animation-timeline: scroll(); }
}if ('gpu' in navigator) { /* WebGPU */ }
else if (canvas.getContext('webgl2')) { /* WebGL2 fallback */ }
/* CSS-only fallback must still look good */Performance rules
Target 60fps. If dropping below 50, simplify.
Lazy-initialize heavy resources (WebGL contexts, WASM modules) only when near viewport.
Pause off-screen rendering. Kill what you can't see.
Test on real mid-range devices, not just your development machine.
Polish is the difference
The gap between "cool" and "extraordinary" is in the last 20% of refinement: the easing curve on a spring animation, the timing offset in a staggered reveal, the subtle secondary motion that makes a transition feel physical. Don't ship the first version that works; ship the version that feels inevitable.
NEVER:
Ship effects that cause jank on mid-range devices
Use bleeding-edge APIs without a functional fallback
Add sound without explicit user opt-in
Use technical ambition to mask weak design fundamentals; fix those first with other commands
Layer multiple competing extraordinary moments. Focus creates impact, excess creates noise
Verify the Result
The wow test: Show it to someone who hasn't seen it. Do they react?
The removal test: Take it away. Does the experience feel diminished, or does nobody notice?
The device test: Run it on a phone, a tablet, a Chromebook. Still smooth?
The context test: Does this make sense for THIS brand and audience?
"Technically extraordinary" isn't about using the newest API. It's about making an interface do something users didn't think a website could do.
Requirements and compatibility
Written for: Claude Code
Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta
“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.
Needs: Claude Code frontmatter, Needs Node.js
Security
What our scanner noticed· Low risk
- Scripts that your agent may run
This skill includes scripts that your agent may run. Read them before you use it.
A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.
Attribution and licence
- Created by
- Paul Bakaus
- Publisher
- Paul Bakaus (Community)
- Source
- pbakaus/impeccable · plugin/skills/impeccable · commit 687bc38
- Licence
- Apache License 2.0 (redistribution allowed)
- LICENSE (added by AutoGineer from LICENSE)
- NOTICE (added by AutoGineer from NOTICE.md)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
AutoGineer is not affiliated with or endorsed by Paul Bakaus or Paul Bakaus.
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download impeccable.zip