impeccable

Designs, critiques, and refines frontend interfaces through sub-command-driven UX workflows.

Updated Oct 16, 2025
One-click install
npx skills add https://github.com/hugotown/dotfiles --skill impeccable-hugotown
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: impeccable
Source: https://github.com/hugotown/dotfiles/tree/main/agents/skills/impeccable
Command: npx skills add https://github.com/hugotown/dotfiles --skill impeccable-hugotown

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? AI-generated interfaces tend to converge on generic, template-like designs with predictable palettes, card grids, and weak hierarchy. This Skill enforces deliberate design decisions by loading project context (PRODUCT.md and DESIGN.md), applying shared design laws, and routing work through specialized commands for building, evaluating, refining, and fixing UI. ## Core Features & Use Cases - Command-based design workflow: 23 sub-commands such as craft, shape, critique, audit, polish, bolder, quieter, animate, colorize, typeset, and harden, each with a dedicated reference file guiding the work. - Context gating: Requires PRODUCT.md (users, brand, principles) and optionally DESIGN.md (colors, typography, components) before any design work, with teach and document commands to generate them. - Anti-pattern enforcement: Absolute bans on AI slop tells like gradient text, side-stripe borders, glassmorphism defaults, and hero-metric templates, plus scored audits across accessibility, performance, theming, and responsive design. - Use Case: A developer asks to redesign a bland dashboard. The skill loads project context, runs a shape discovery interview to confirm a design brief, then builds the UI following brand or product register rules, and finishes with audit and polish passes. ## Quick Start Ask the agent to use the impeccable skill to critique your landing page or craft a new feature UI for your project.

Frequently Asked Questions about impeccable

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I improve a bland or generic UI design with AI?▼

Run the impeccable skill's bolder command on the target to amplify hierarchy, scale contrast, and typography while rejecting AI slop patterns like purple-blue gradients and glassmorphism. It requires a loaded PRODUCT.md context first so changes stay on-brand.

How do I run a UX audit on a frontend component?▼

Use the audit command, which scores accessibility, performance, theming, responsive design, and anti-patterns on a 0-4 scale each. It produces a report with P0-P3 severity findings and recommends follow-up commands like polish or optimize.

What are PRODUCT.md and DESIGN.md files used for?▼

PRODUCT.md captures users, brand, tone, and strategic principles, while DESIGN.md records colors, typography, and components. The skill loads both via its load-context script before any design work, and the teach or document commands generate them when missing.

Does this skill work for backend or non-UI tasks?▼

No. The skill explicitly scopes itself to frontend interface work such as pages, components, forms, and design systems. Backend-only or non-UI tasks fall outside its stated purpose and routing rules.

Why does the skill refuse to edit files before running setup?▼

The preflight gates ensure design decisions are grounded in project context rather than generic defaults. Skipping context loading or the confirmed shape brief produces output that ignores the product's brand, users, and existing design system.