pbakaus/impeccablePublic

The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.

AI summary: A design guidance tool and rule detector for AI coding agents to eliminate generic frontend tropes.

Stars
114.1K
+63 today
Forks
6.8K
Watchers
220
Open issues
35
Open PRs
18
Contributors
~66
Commits
3.3K
Branches
481
Views (30d)
10

RustApache-2.0Created Nov 16, 2025Last push todayLatest release cli-v4.9.2+3.9K stars this week+29.1K this month

Quick answers

What is impeccable?
A design guidance tool and rule detector for AI coding agents to eliminate generic frontend tropes.
What does impeccable do?
Impeccable is a specialized design vocabulary and enforcement tool built to elevate the quality of frontend code generated by AI assistants. It specifically targets and eliminates common 'AI design tells'—like overused purple gradients, nested cards, and generic typography—by establishing a strict shared design context between the developer and the LLM. It initializes projects with explicit brand guidelines and provides 23 specialized commands (e.g., 'polish', 'quieter') to steer the AI's aesthetic choices. Crucially, it includes a suite of 60 deterministic, non-LLM detector rules that can instantly audit generated UI components for design flaws without requiring expensive API calls.
Who is impeccable for?
Frontend developers, designers, and engineering teams who heavily rely on AI coding assistants but require the output to be highly polished, on-brand, and structurally sound. It is designed to enforce design systems and maintain a high bar of visual quality in an automated workflow.
How do I get started with impeccable?
npx impeccable install && /impeccable <command> <target>
How popular is impeccable on GitHub?
pbakaus/impeccable has 114,095 stars and 6,782 forks on GitHub, and gained 3,901 stars in the last 7 days.
What license does impeccable use?
pbakaus/impeccable is released under the Apache-2.0 license.

Star history

since Jul 27, 2026
050K100KJul 2026Sep 2026Oct 2026Nov 2026
114.1K stars as of Nov 21, 2026. Measured daily since Jul 27, 2026; GitHub no longer exposes earlier star timestamps.

Update history

7 recorded
  • Nov 17, 2026New release cli-v4.9.2 (previously cli-v4.8.1).
  • Nov 8, 2026New release cli-v4.8.1 (previously cli-v4.8.0).
  • Oct 30, 2026New release cli-v4.8.0 (previously cli-v4.7.0).
  • Oct 28, 2026Description changed from "The design language that makes your AI harness better at design." to "The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop".
  • Oct 21, 2026New release cli-v4.7.0 (previously skill-v4.5.2).
  • Oct 18, 2026Primary language changed from JavaScript to Rust.
  • Oct 12, 2026New release skill-v4.5.2 (previously engine-v0.1.8).

Contribution activity

commits per day, last 52 weeks
NovDecJanFebMarAprMayJunJulAugSepOctNovMonWedFri2025-11-23: 0 commits2025-11-24: 0 commits2025-11-25: 0 commits2025-11-26: 0 commits2025-11-27: 0 commits2025-11-28: 0 commits2025-11-29: 0 commits2025-11-30: 0 commits2025-12-01: 0 commits2025-12-02: 0 commits2025-12-03: 0 commits2025-12-04: 0 commits2025-12-05: 0 commits2025-12-06: 3 commits2025-12-07: 0 commits2025-12-08: 0 commits2025-12-09: 0 commits2025-12-10: 0 commits2025-12-11: 0 commits2025-12-12: 0 commits2025-12-13: 0 commits2025-12-14: 1 commit2025-12-15: 4 commits2025-12-16: 31 commits2025-12-17: 0 commits2025-12-18: 0 commits2025-12-19: 0 commits2025-12-20: 0 commits2025-12-21: 0 commits2025-12-22: 0 commits2025-12-23: 0 commits2025-12-24: 0 commits2025-12-25: 0 commits2025-12-26: 0 commits2025-12-27: 0 commits2025-12-28: 0 commits2025-12-29: 0 commits2025-12-30: 0 commits2025-12-31: 0 commits2026-01-01: 0 commits2026-01-02: 0 commits2026-01-03: 0 commits2026-01-04: 0 commits2026-01-05: 0 commits2026-01-06: 6 commits2026-01-07: 11 commits2026-01-08: 19 commits2026-01-09: 6 commits2026-01-10: 0 commits2026-01-11: 8 commits2026-01-12: 1 commit2026-01-13: 0 commits2026-01-14: 0 commits2026-01-15: 0 commits2026-01-16: 4 commits2026-01-17: 0 commits2026-01-18: 0 commits2026-01-19: 0 commits2026-01-20: 0 commits2026-01-21: 0 commits2026-01-22: 0 commits2026-01-23: 0 commits2026-01-24: 0 commits2026-01-25: 0 commits2026-01-26: 0 commits2026-01-27: 0 commits2026-01-28: 0 commits2026-01-29: 0 commits2026-01-30: 0 commits2026-01-31: 0 commits2026-02-01: 0 commits2026-02-02: 0 commits2026-02-03: 0 commits2026-02-04: 0 commits2026-02-05: 0 commits2026-02-06: 0 commits2026-02-07: 0 commits2026-02-08: 0 commits2026-02-09: 0 commits2026-02-10: 0 commits2026-02-11: 0 commits2026-02-12: 0 commits2026-02-13: 0 commits2026-02-14: 0 commits2026-02-15: 0 commits2026-02-16: 0 commits2026-02-17: 0 commits2026-02-18: 0 commits2026-02-19: 0 commits2026-02-20: 0 commits2026-02-21: 0 commits2026-02-22: 0 commits2026-02-23: 0 commits2026-02-24: 0 commits2026-02-25: 0 commits2026-02-26: 0 commits2026-02-27: 0 commits2026-02-28: 0 commits2026-03-01: 0 commits2026-03-02: 0 commits2026-03-03: 0 commits2026-03-04: 14 commits2026-03-05: 8 commits2026-03-06: 0 commits2026-03-07: 1 commit2026-03-08: 3 commits2026-03-09: 0 commits2026-03-10: 4 commits2026-03-11: 1 commit2026-03-12: 6 commits2026-03-13: 1 commit2026-03-14: 3 commits2026-03-15: 14 commits2026-03-16: 11 commits2026-03-17: 23 commits2026-03-18: 8 commits2026-03-19: 13 commits2026-03-20: 9 commits2026-03-21: 5 commits2026-03-22: 1 commit2026-03-23: 2 commits2026-03-24: 13 commits2026-03-25: 1 commit2026-03-26: 0 commits2026-03-27: 4 commits2026-03-28: 3 commits2026-03-29: 1 commit2026-03-30: 11 commits2026-03-31: 4 commits2026-04-01: 1 commit2026-04-02: 4 commits2026-04-03: 25 commits2026-04-04: 0 commits2026-04-05: 5 commits2026-04-06: 8 commits2026-04-07: 13 commits2026-04-08: 52 commits2026-04-09: 12 commits2026-04-10: 20 commits2026-04-11: 3 commits2026-04-12: 12 commits2026-04-13: 18 commits2026-04-14: 4 commits2026-04-15: 2 commits2026-04-16: 1 commit2026-04-17: 4 commits2026-04-18: 0 commits2026-04-19: 0 commits2026-04-20: 1 commit2026-04-21: 11 commits2026-04-22: 55 commits2026-04-23: 14 commits2026-04-24: 9 commits2026-04-25: 6 commits2026-04-26: 2 commits2026-04-27: 9 commits2026-04-28: 20 commits2026-04-29: 9 commits2026-04-30: 4 commits2026-05-01: 0 commits2026-05-02: 4 commits2026-05-03: 4 commits2026-05-04: 4 commits2026-05-05: 0 commits2026-05-06: 0 commits2026-05-07: 0 commits2026-05-08: 0 commits2026-05-09: 0 commits2026-05-10: 0 commits2026-05-11: 0 commits2026-05-12: 2 commits2026-05-13: 6 commits2026-05-14: 5 commits2026-05-15: 1 commit2026-05-16: 0 commits2026-05-17: 1 commit2026-05-18: 2 commits2026-05-19: 0 commits2026-05-20: 0 commits2026-05-21: 0 commits2026-05-22: 0 commits2026-05-23: 1 commit2026-05-24: 0 commits2026-05-25: 0 commits2026-05-26: 0 commits2026-05-27: 0 commits2026-05-28: 26 commits2026-05-29: 6 commits2026-05-30: 1 commit2026-05-31: 0 commits2026-06-01: 1 commit2026-06-02: 9 commits2026-06-03: 6 commits2026-06-04: 0 commits2026-06-05: 16 commits2026-06-06: 2 commits2026-06-07: 0 commits2026-06-08: 17 commits2026-06-09: 15 commits2026-06-10: 1 commit2026-06-11: 1 commit2026-06-12: 0 commits2026-06-13: 1 commit2026-06-14: 5 commits2026-06-15: 9 commits2026-06-16: 6 commits2026-06-17: 6 commits2026-06-18: 0 commits2026-06-19: 7 commits2026-06-20: 13 commits2026-06-21: 4 commits2026-06-22: 4 commits2026-06-23: 1 commit2026-06-24: 0 commits2026-06-25: 3 commits2026-06-26: 4 commits2026-06-27: 0 commits2026-06-28: 0 commits2026-06-29: 4 commits2026-06-30: 1 commit2026-07-01: 10 commits2026-07-02: 1 commit2026-07-03: 3 commits2026-07-04: 2 commits2026-07-05: 0 commits2026-07-06: 4 commits2026-07-07: 5 commits2026-07-08: 16 commits2026-07-09: 9 commits2026-07-10: 9 commits2026-07-11: 20 commits2026-07-12: 41 commits2026-07-13: 29 commits2026-07-14: 16 commits2026-07-15: 7 commits2026-07-16: 0 commits2026-07-17: 2 commits2026-07-18: 7 commits2026-07-19: 3 commits2026-07-20: 13 commits2026-07-21: 50 commits2026-07-22: 37 commits2026-07-23: 10 commits2026-07-24: 10 commits2026-07-25: 29 commits2026-07-26: 18 commits2026-07-27: 43 commits2026-07-28: 43 commits2026-07-29: 30 commits2026-07-30: 17 commits2026-07-31: 18 commits2026-08-01: 6 commits2026-08-02: 3 commits2026-08-03: 26 commits2026-08-04: 14 commits2026-08-05: 5 commits2026-08-06: 0 commits2026-08-07: 0 commits2026-08-08: 7 commits2026-08-09: 15 commits2026-08-10: 11 commits2026-08-11: 11 commits2026-08-12: 19 commits2026-08-13: 22 commits2026-08-14: 23 commits2026-08-15: 16 commits2026-08-16: 32 commits2026-08-17: 23 commits2026-08-18: 1 commit2026-08-19: 3 commits2026-08-20: 2 commits2026-08-21: 8 commits2026-08-22: 14 commits2026-08-23: 7 commits2026-08-24: 12 commits2026-08-25: 9 commits2026-08-26: 5 commits2026-08-27: 3 commits2026-08-28: 20 commits2026-08-29: 1 commit2026-08-30: 0 commits2026-08-31: 15 commits2026-09-01: 25 commits2026-09-02: 9 commits2026-09-03: 9 commits2026-09-04: 19 commits2026-09-05: 13 commits2026-09-06: 12 commits2026-09-07: 11 commits2026-09-08: 12 commits2026-09-09: 7 commits2026-09-10: 18 commits2026-09-11: 13 commits2026-09-12: 26 commits2026-09-13: 33 commits2026-09-14: 19 commits2026-09-15: 1 commit2026-09-16: 1 commit2026-09-17: 0 commits2026-09-18: 35 commits2026-09-19: 2 commits2026-09-20: 0 commits2026-09-21: 2 commits2026-09-22: 4 commits2026-09-23: 0 commits2026-09-24: 4 commits2026-09-25: 0 commits2026-09-26: 0 commits2026-09-27: 0 commits2026-09-28: 1 commit2026-09-29: 4 commits2026-09-30: 12 commits2026-10-01: 18 commits2026-10-02: 25 commits2026-10-03: 5 commits2026-10-04: 66 commits2026-10-05: 58 commits2026-10-06: 13 commits2026-10-07: 7 commits2026-10-08: 11 commits2026-10-09: 1 commit2026-10-10: 0 commits2026-10-11: 1 commit2026-10-12: 3 commits2026-10-13: 0 commits2026-10-14: 14 commits2026-10-15: 13 commits2026-10-16: 20 commits2026-10-17: 1 commit2026-10-18: 10 commits2026-10-19: 7 commits2026-10-20: 5 commits2026-10-21: 19 commits2026-10-22: 15 commits2026-10-23: 27 commits2026-10-24: 1 commit2026-10-25: 2 commits2026-10-26: 22 commits2026-10-27: 2 commits2026-10-28: 7 commits2026-10-29: 3 commits2026-10-30: 8 commits2026-10-31: 7 commits2026-11-01: 7 commits2026-11-02: 6 commits2026-11-03: 9 commits2026-11-04: 14 commits2026-11-05: 19 commits2026-11-06: 12 commits2026-11-07: 5 commits2026-11-08: 26 commits2026-11-09: 87 commits2026-11-10: 79 commits2026-11-11: 58 commits2026-11-12: 66 commits2026-11-13: 55 commits2026-11-14: 44 commits2026-11-15: 6 commits2026-11-16: 1 commit2026-11-17: 0 commits2026-11-18: 0 commits2026-11-19: 0 commits2026-11-20: 0 commits2026-11-21: 0 commits
2,793 commits in the last yearLessMore

Signals and awards

derived from tracked data
  • Landmark project

    114,095 stars

  • Very active

    2,793 commits in 52 weeks

  • Permissive license

    Apache-2.0

  • Repeat trending

    74 trending appearances

  • Top 10% tracked

    Rank 72 of 1243

What impeccable does

Impeccable is a specialized design vocabulary and enforcement tool built to elevate the quality of frontend code generated by AI assistants. It specifically targets and eliminates common 'AI design tells'—like overused purple gradients, nested cards, and generic typography—by establishing a strict shared design context between the developer and the LLM. It initializes projects with explicit brand guidelines and provides 23 specialized commands (e.g., 'polish', 'quieter') to steer the AI's aesthetic choices. Crucially, it includes a suite of 60 deterministic, non-LLM detector rules that can instantly audit generated UI components for design flaws without requiring expensive API calls.

Frontend developers, designers, and engineering teams who heavily rely on AI coding assistants but require the output to be highly polished, on-brand, and structurally sound. It is designed to enforce design systems and maintain a high bar of visual quality in an automated workflow.

  • Shared Design Context: Initialize projects with `PRODUCT.md` and `DESIGN.md` files to explicitly define brand voice, color palettes, and anti-references for the AI.
  • Specialized AI Commands: Utilize 23 specific directives like `audit`, `distill`, and `bolder` to precisely guide the AI's iterative design process.
  • Deterministic Defect Detection: Run 60 hardcoded, non-LLM rules locally to instantly catch common AI design flaws like poor contrast or inconsistent spacing.
  • Anti-Trope Enforcement: Actively prevent the generation of generic SaaS templates, overused gradients, and repetitive component structures.
  • Multi-Interface Auditing: Execute design checks seamlessly via a CLI tool against local code or through a browser extension against live websites.

Where teams use it

Guiding Brand-Specific Generation

Use context files to ensure an AI assistant generates React components that perfectly match a company's unique aesthetic rather than a generic template.

Automated UI Auditing

Run the deterministic CLI rules against newly generated AI components to instantly identify and correct accessibility or visual hierarchy issues.

Iterative Design Refinement

Employ commands like `/impeccable critique` to force an AI coding agent to re-evaluate and improve its own layout choices before finalizing code.

Standardizing Team Output

Deploy the tool across an engineering team to ensure all AI-assisted frontend work adheres strictly to a baseline of professional design principles.

Getting started: npx impeccable install && /impeccable <command> <target>

README

main branch

Impeccable

The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, and catch AI slop before it ships.

From your project root:

npx impeccable install

Reload your coding tool, then run /impeccable init in your agent ($impeccable init on Codex).

Works with Claude Code, Cursor, Codex CLI, GitHub Copilot, Devin, Replit Agent, Gemini CLI, Grok Build, OpenCode, Google Antigravity, Kiro, Trae, Rovo Dev, Qoder, Mistral Vibe, Pi, Hermes Agent, DeepSeek Harness, and Veto. Full docs live at impeccable.style/docs.

Without Impeccable With Impeccable
Villa Castagneto built without Impeccable: cream background, a thin serif headline with an italic accent, two pill buttons, and flat vector illustrations in rounded cards Villa Castagneto built with Impeccable: a full-bleed engraved night scene of the villa on its cliff above the sea, a condensed cream and vermilion headline, and a month strip along the bottom

Same model (Fable 5.1), same brief: a fourteen-room family guesthouse on the Ligurian coast. Without Impeccable, it builds the tasteful default: cream page, thin serif, italic accent, pill buttons. With it, the page is built around one picture: the house at night, seen from the water.

For a full project, see the Neo Mirai case study: a conference site taken from mockup to shipped page.

Why

Inter for everything. Purple-to-blue gradients. Cards nested in cards, gray text on colored backgrounds, a rounded-square icon tile above every heading. Ask an agent for a page with no other guidance and these show up again and again, across models and projects.

  • Words for what you want. "Make it pop" leaves your agent to guess. /impeccable bolder the pricing cards loads a playbook written for that one move and points it at one target.
  • A reviewer. critique scores the design against usability heuristics and ranks what to fix first. audit checks accessibility, performance, theming, and responsive behavior, with findings ranked P0 (blocking) to P3 (polish).
  • A slop detector. 62 deterministic rules flag the tells above, plus quality problems like cramped padding and skipped headings. No LLM, no API key.

Impeccable is strongest on interfaces that already exist: point it at a page or a component and iterate. It builds new pages too; see Build something new for how to get the most out of that harder mode. To start, pick one component:

/impeccable critique the pricing cards

How it works

Run /impeccable init once per project. It reads your code, asks only what it can't infer (who the product is for, what it needs to do, the constraints), and writes PRODUCT.md. Every later command reads it. Run /impeccable document to capture your existing visual system in DESIGN.md, so changes stay on-brand. More on context files.

Then name a command and a target:

/impeccable critique the onboarding flow
/impeccable quieter the landing page
/impeccable polish settings
/impeccable harden checkout

Or just describe what you want: /impeccable redo this hero section. Narrow targets get better results; a single section reviewed closely beats a whole page at a glance. Pin a command you use often with /impeccable pin audit to get /audit as its own shortcut.

24 commands

Commands
Steer bolder amplifies safe designs · quieter tones down loud ones · distill removes what the page doesn't need · colorize brings color to a gray interface · typeset fixes fonts, hierarchy, and sizing · layout fixes spacing and rhythm · animate adds transitions and interaction feedback · delight adds personality · overdrive goes for shaders, spring physics, and scroll-driven effects
Review critique is a scored UX review · audit is a technical quality report
Finish polish is the final pass before shipping · harden covers errors, i18n, overflow, and edge cases · clarify rewrites unclear copy · adapt handles screen sizes and devices · optimize fixes loading and rendering performance · onboard designs first-run flows and empty states
Iterate live live lets you pick an element in the browser and cycle through variants · generate produces variants of a named element without manual picking
Plan and set up shape plans UX before code · init writes PRODUCT.md · document writes DESIGN.md · extract pulls repeated patterns into your design system

The 24th, craft, is a deprecated alias for a plain build request. Type /impeccable alone to see the list in your agent. Each command has its own page: impeccable.style/docs.

On Codex, open /skills or type $impeccable instead of the slash command.

Live mode

/impeccable live opens your running dev server with an overlay. Select an element, pick a direction, and Impeccable hot-swaps variants in place. Accept one and it is written back to your source. It works with Vite, Next, SvelteKit, Astro, Nuxt, and plain HTML. Iterate in the browser.

Live mode edits a local checkout only; don't inject it into a deployed site or weaken a production CSP to make it work. Applying copy edits runs your package.json's optional impeccable:manual-edit-validate script with your permissions, so review it before using live mode in an unfamiliar repo.

Apply sends staged copy edits to your chat agent while a live session is polling. If none has polled in the last minute, it runs the codex CLI from your PATH instead (or claude when codex is missing), with approvals, permission checks, and sandboxing off (--dangerously-bypass-approvals-and-sandbox or --permission-mode bypassPermissions) and your environment inherited. Its prompt carries the staged edits, the edited elements' HTML and nearby text, the page URL, and candidate source paths. Set IMPECCABLE_LIVE_COPY_AGENT=chat in the environment that starts live mode to keep Apply in your chat session, or off to disable Apply. The server reads it once at startup.

Three ways to run the detector

In your agent. The design hook scans every UI file your agent edits and hands the findings back before the agent calls the work done. This is where most slop gets caught: without the hook, the detector only runs when someone remembers to run it. It's available on Claude Code, Cursor, Codex, GitHub Copilot, Grok Build, and Hermes Agent, and the installer sets it up. Say yes. Automatic design checks.

In CI or your terminal. The CLI needs no agent:

npx impeccable detect src/                   # scan a directory
npx impeccable detect https://example.com    # scan a rendered page (uses your installed Chrome or Edge)
npx impeccable detect --json .               # machine-readable output
npx impeccable detect --github src/          # GitHub Actions annotations
npx impeccable detect --list-rules           # every rule with its id and description

Source files like JSX and TSX get the pattern rules only. Rules that need a rendered page, such as low contrast and tiny text, run when you scan a URL, so point the CLI at your dev server too: npx impeccable detect http://localhost:5173.

Exit code 2 means findings, 1 means a target couldn't be scanned. To allow your brand font everywhere, run npx impeccable ignores add-value overused-font Inter --reason "Brand font". To turn a rule off for one file, add a comment: <!-- impeccable-disable overused-font: exported brand doc -->. Run a detector scan · Configuration and ignores.

In your browser. The Chrome extension overlays the same findings on any live page, yours or anyone else's. Review with a visual overlay.

Installation

npx impeccable install

The installer detects your coding tools, asks whether to install for this project or globally, and offers the design hook where your tool supports one. Accept the hook. Reload your tool afterward. npx impeccable update refreshes an existing install. For scripts, pass --providers=claude,codex,cursor and --scope=project|global.

Three tools need one more step before the hook runs. In Codex, open /hooks and approve the project hook (again after an update that changes it). In Grok Build, run /hooks-trust or launch with --trust. In Hermes Agent, the hook is a plugin: run hermes plugins enable impeccable-design-hook once. Allow the hook in your harness.

Node is only needed for npx. The skill itself runs a self-contained engine binary that ships next to it or downloads once into ~/.impeccable/bin/.

Claude Code, Copilot, and Grok plugins

Claude Code: /plugin marketplace add pbakaus/impeccable, then open /plugin and install Impeccable.

GitHub Copilot in VS Code: install Impeccable from the Visual Studio Marketplace or run code --install-extension renaissance-geek.impeccable. Needs VS Code 1.109.3+, Copilot Chat, and a trusted workspace. It installs the skill without the hook. Details.

Grok Build: grok plugin install pbakaus/impeccable#plugin --trust installs the skill, agents, and hook.

Git submodule (a pinned version for the whole team)
git submodule add https://github.com/pbakaus/impeccable vendor/impeccable
npx impeccable link --source=vendor/impeccable --providers=claude,cursor

Commit .gitmodules, the submodule, and the generated links. Teammates run git submodule update --init --recursive. To upgrade, run git submodule update --remote vendor/impeccable, rerun the link command, and commit. Linking installs skills, not hooks. Existing skill folders stay put unless you pass --force.

Manual copy, no Node required

Download the ZIP for your tool from impeccable.style, or clone this repo: each tool's build is committed at the repo root. Copy skills/impeccable from the folder below into the same place in your project, or into the global folder.

Tool Repo folder Global skills folder
Claude Code .claude/ ~/.claude/skills/
Cursor .cursor/
Codex CLI, Replit Agent .agents/ ~/.agents/skills/
Devin .devin/ ${XDG_CONFIG_HOME:-$HOME/.config}/devin/skills/
GitHub Copilot .github/
Gemini CLI .gemini/
Google Antigravity .agent/ ~/.gemini/config/skills/
OpenCode .opencode/
Grok Build .grok/ ~/.grok/skills/
Hermes Agent .hermes/ ${HERMES_HOME:-$HOME/.hermes}/skills/
DeepSeek Harness .dsh/ ${DSH_HOME:-$HOME/.dsh}/skills/
Pi .pi/
Qoder .qoder/ ~/.qoder/skills/
Rovo Dev .rovodev/ ~/.rovodev/skills/
Mistral Vibe .vibe/ ~/.vibe/skills/
Trae .trae/ ~/.trae/skills/
Trae China .trae-cn/ ~/.trae-cn/skills/

For example: mkdir -p your-project/.claude/skills && cp -r .claude/skills/impeccable your-project/.claude/skills/.

Notes:

  • A manual copy skips the design hook and subagents. Run npx impeccable install to get them; it writes each tool's hook pointing at the right skill path.
  • OpenCode also needs .opencode/commands/impeccable.md copied into your project's .opencode/commands/ to provide /impeccable.
  • Hermes asks you to trust project-local skills once: run hermes skills trust from the project root. Global installs need no trust step.
  • Cursor and Gemini CLI may need Agent Skills enabled in settings. See the Cursor and Gemini CLI skills docs.
  • Restart Trae after copying.
  • impeccable install and update manage a DeepSeek Harness global copy only when DSH_HOME is inside your home directory.

Project files and git

Impeccable writes its working files under .impeccable/. A few are shared project artifacts and belong in the repo: config.json, live/config.json, design.json, surfaces/*.md, and critique/*.md. Keep PRODUCT.md and DESIGN.md in the repo too. The rest is screenshots, caches, and runtime state.

Copy the .gitignore entries
# impeccable-ignore-start
# Ephemeral output, runtime state, and per-dev overrides.
# The **/ prefix covers .impeccable at the repo root or in a nested workspace.
# Shared artifacts stay tracked: config.json, live/config.json,
# design.json, surfaces/*.md, critique/*.md.
**/.impeccable/config.local.json
**/.impeccable/hook.cache.json
**/.impeccable/hook.pending.json
**/.impeccable/*.png
**/.impeccable/review/
**/.impeccable/questions/
**/.impeccable/live/server.json
**/.impeccable/live/sessions/
**/.impeccable/live/previews/
**/.impeccable/live/annotations/
**/.impeccable/live/cache/
**/.impeccable/live/manual-edit-apply-transaction.json
**/.impeccable/live/manual-edit-events.jsonl
**/.impeccable/live/manual-edit-evidence/
**/.impeccable/live/pending-manual-edits.json
**/.impeccable/live/deferred-svelte-component-accepts.json
**/.impeccable/live/*.png
# impeccable-ignore-end

The folders that hold decision-round state (.impeccable/questions/, .impeccable/mocks/worlds/) also ignore themselves. A .gitignore can't untrack a file git already tracks; if you committed one earlier, run git rm --cached <path>.

Good to know

Build path. For new landing pages and showcase surfaces, Impeccable can generate a full-fidelity comp first and build to match it (bolder, slower), or build straight in code (leaner, faster). App screens and documents are always built in code. init asks once and saves the answer as buildPath in .impeccable/config.json; the decision page lets you override it for one session. The choice only appears when your harness can generate images. Image generation · Configuration.

Native apps. Set ## Platform in PRODUCT.md to ios, android, or adaptive (one Flutter or React Native codebase that follows each OS), and the design commands work from Apple's HIG or Material 3 instead of web conventions. init asks when it can't tell. audit and adapt switch to native versions, and the native audit reads SwiftUI, Compose, React Native, or Flutter source directly. The detector, live mode with its generate shortcut, and the edit hook stay web-only, because they work on HTML and CSS in a browser.

Hooks run outside model approval. In Claude Code, installed command hooks run even when you deny the model's own commands, so the first edit can download the engine. Review installed hooks before unattended runs, or pass --settings '{"disableAllHooks": true}' to turn them off for a run. The installer leaves hook entries it didn't add alone.

Something broken? /impeccable doctor finds stale context files, unused settings, and broken hooks. Fix setup problems.

Telemetry. When a new design starts, the skill fetches a set of visual directions from the impeccable.style catalog. Turning telemetry off doesn't stop that request; it stops the anonymous record of which directions were shown and which one you picked, which is how the catalog learns what works. Your project name, files, code, and PRODUCT.md are never sent. Disable telemetry with npx impeccable telemetry off, DO_NOT_TRACK=1, or "telemetry": false in .impeccable/config.json for the whole project. The full list of what is sent is on the privacy page.

Community

  • Issues for bugs, questions, and ideas. Outside contributions start with an issue; see DEVELOP.md.
  • Changelog for what shipped.
  • Follow @pbakaus for release notes and new rules.

Sponsors

CI powered by Namespace

Thanks to Namespace for sponsoring Impeccable's CI with fast Linux and Windows runners.

License

Apache 2.0. See LICENSE. Impeccable started from Anthropic's frontend-design skill.


Created by Paul Bakaus

View on GitHub

Recent activity

commits and pull requests

Recent open issues

view all

Releases and announcements

113 total
  1. CLI 4.9.2cli-v4.9.2Nov 16, 2026

    - **Loop 0.1.3.** `loop install` and `loop update` verify it against its pinned checksum. - **Your taste in every agent.** `loop connect` offers to add your Impeccable taste to your agents' rule files. Answer ahead of time with `--taste` or `--no-taste`. - **Signing in does more.** `login` offers Loop when your plan includes it, and the first sign-in inside a repository adds that repository to your account.

  2. Impeccable Loop 0.1.3loop-v0.1.3Nov 15, 202644 downloads

    Loop's cards have a new, calmer look with a clock for what's due. Answered cards fold into an outbox once your agent has read them. Wakes retry when they fail. One Loop runs per Mac.

  3. impeccable engine engine-v0.1.25engine-v0.1.25Nov 15, 202655K downloads

    Prebuilt impeccable engine binaries (engine-v0.1.25). The launcher, the npm shim and impeccable install download these on first run. Docs: https://impeccable.style

  4. Skill 4.9.1skill-v4.9.1Nov 14, 202651.2K downloads

    - **Start from a world.** `impeccable world <id>` writes that world's design system as your DESIGN.md, beside PRODUCT.md, and never overwrites one you have. Later direction rounds name the world you chose instead of dealing new ones. Needs a signed-in account. - **Live on a first page.** In an empty folder, Live says there is no page yet and offers to craft one, instead of leaving files behind. A plain HTML page gets its one-line config written for it. The first pick works on a bare element, and a first session tells you what to click. - **Live edits stay on their line.** Live can wrap an element that shares its line with other markup, and accepting a variant never removes the rest of that line. - **Walkthroughs from any recording.** `impeccable walkthrough` turns a screen recording into an MP4, a poster and chapters, ready for a Needs you walkthrough card. - **Agents that use Loop.** `impeccable loop connect` now teaches your coding agents to ask through Needs you, and tells them that Loop wakes them when you answer. - **Foundations from your files.** `impeccable foundations` checks 16 of its 18 launch items from local files. It leaves an item unchecked when it couldn't see e

  5. CLI 4.9.1cli-v4.9.1Nov 14, 2026

    - **New verbs.** `world` seeds DESIGN.md from a catalog world, `walkthrough` turns a recording into a walkthrough card, and `foundations` checks launch readiness from local files. - **Loop.** `loop connect` now teaches your agents to ask through Needs you.

Code frequency

additions and deletions
+1.2M-1.2MWeek of 2025-11-23: +0 linesWeek of 2025-11-23: -0 linesWeek of 2025-11-30: +7,308 linesWeek of 2025-11-30: -3,871 linesWeek of 2025-12-07: +0 linesWeek of 2025-12-07: -0 linesWeek of 2025-12-14: +27,521 linesWeek of 2025-12-14: -21,381 linesWeek of 2025-12-21: +0 linesWeek of 2025-12-21: -0 linesWeek of 2025-12-28: +0 linesWeek of 2025-12-28: -0 linesWeek of 2026-01-04: +27,244 linesWeek of 2026-01-04: -34,094 linesWeek of 2026-01-11: +5,055 linesWeek of 2026-01-11: -1,789 linesWeek of 2026-01-18: +0 linesWeek of 2026-01-18: -0 linesWeek of 2026-01-25: +0 linesWeek of 2026-01-25: -0 linesWeek of 2026-02-01: +0 linesWeek of 2026-02-01: -0 linesWeek of 2026-02-08: +0 linesWeek of 2026-02-08: -0 linesWeek of 2026-02-15: +0 linesWeek of 2026-02-15: -0 linesWeek of 2026-02-22: +0 linesWeek of 2026-02-22: -0 linesWeek of 2026-03-01: +24,402 linesWeek of 2026-03-01: -23,605 linesWeek of 2026-03-08: +2,626 linesWeek of 2026-03-08: -4,420 linesWeek of 2026-03-15: +61,382 linesWeek of 2026-03-15: -20,847 linesWeek of 2026-03-22: +15,736 linesWeek of 2026-03-22: -10,804 linesWeek of 2026-03-29: +50,053 linesWeek of 2026-03-29: -36,968 linesWeek of 2026-04-05: +91,178 linesWeek of 2026-04-05: -75,290 linesWeek of 2026-04-12: +93,236 linesWeek of 2026-04-12: -18,731 linesWeek of 2026-04-19: +84,904 linesWeek of 2026-04-19: -22,034 linesWeek of 2026-04-26: +81,105 linesWeek of 2026-04-26: -32,611 linesWeek of 2026-05-03: +59,025 linesWeek of 2026-05-03: -44,042 linesWeek of 2026-05-10: +9,897 linesWeek of 2026-05-10: -3,377 linesWeek of 2026-05-17: +154,812 linesWeek of 2026-05-17: -6,244 linesWeek of 2026-05-24: +231,825 linesWeek of 2026-05-24: -45,483 linesWeek of 2026-05-31: +60,903 linesWeek of 2026-05-31: -8,233 linesWeek of 2026-06-07: +102,215 linesWeek of 2026-06-07: -81,728 linesWeek of 2026-06-14: +99,478 linesWeek of 2026-06-14: -5,825 linesWeek of 2026-06-21: +4,220 linesWeek of 2026-06-21: -993 linesWeek of 2026-06-28: +3,073 linesWeek of 2026-06-28: -1,289 linesWeek of 2026-07-05: +42,011 linesWeek of 2026-07-05: -13,809 linesWeek of 2026-07-12: +239,000 linesWeek of 2026-07-12: -143,449 linesWeek of 2026-07-19: +301,428 linesWeek of 2026-07-19: -149,597 linesWeek of 2026-07-26: +146,241 linesWeek of 2026-07-26: -33,707 linesWeek of 2026-08-02: +25,831 linesWeek of 2026-08-02: -7,972 linesWeek of 2026-08-09: +206,888 linesWeek of 2026-08-09: -22,182 linesWeek of 2026-08-16: +12,220 linesWeek of 2026-08-16: -4,362 linesWeek of 2026-08-23: +110,152 linesWeek of 2026-08-23: -9,477 linesWeek of 2026-08-30: +316,940 linesWeek of 2026-08-30: -1,233,205 linesWeek of 2026-09-06: +64,346 linesWeek of 2026-09-06: -3,932 linesWeek of 2026-09-13: +68,428 linesWeek of 2026-09-13: -4,945 linesWeek of 2026-09-20: +20,425 linesWeek of 2026-09-20: -897 linesWeek of 2026-09-27: +33,918 linesWeek of 2026-09-27: -4,347 linesWeek of 2026-10-04: +24,533 linesWeek of 2026-10-04: -3,740 linesWeek of 2026-10-11: +40,384 linesWeek of 2026-10-11: -3,256 linesWeek of 2026-10-18: +43,811 linesWeek of 2026-10-18: -5,191 linesWeek of 2026-10-25: +45,339 linesWeek of 2026-10-25: -5,865 linesWeek of 2026-11-01: +15,421 linesWeek of 2026-11-01: -5,809 linesWeek of 2026-11-08: +72,654 linesWeek of 2026-11-08: -26,762 linesWeek of 2026-11-15: +202 linesWeek of 2026-11-15: -201 linesNov 23, 2025Nov 15, 2026
+3.1M lines added, -2.2M removed over the last year.

Commits per week

last 52 weeks
4150Week of 2025-11-23: 0 commitsWeek of 2025-11-30: 3 commitsWeek of 2025-12-07: 0 commitsWeek of 2025-12-14: 36 commitsWeek of 2025-12-21: 0 commitsWeek of 2025-12-28: 0 commitsWeek of 2026-01-04: 42 commitsWeek of 2026-01-11: 13 commitsWeek of 2026-01-18: 0 commitsWeek of 2026-01-25: 0 commitsWeek of 2026-02-01: 0 commitsWeek of 2026-02-08: 0 commitsWeek of 2026-02-15: 0 commitsWeek of 2026-02-22: 0 commitsWeek of 2026-03-01: 23 commitsWeek of 2026-03-08: 18 commitsWeek of 2026-03-15: 83 commitsWeek of 2026-03-22: 24 commitsWeek of 2026-03-29: 46 commitsWeek of 2026-04-05: 113 commitsWeek of 2026-04-12: 41 commitsWeek of 2026-04-19: 96 commitsWeek of 2026-04-26: 48 commitsWeek of 2026-05-03: 8 commitsWeek of 2026-05-10: 14 commitsWeek of 2026-05-17: 4 commitsWeek of 2026-05-24: 33 commitsWeek of 2026-05-31: 34 commitsWeek of 2026-06-07: 35 commitsWeek of 2026-06-14: 46 commitsWeek of 2026-06-21: 16 commitsWeek of 2026-06-28: 21 commitsWeek of 2026-07-05: 63 commitsWeek of 2026-07-12: 102 commitsWeek of 2026-07-19: 152 commitsWeek of 2026-07-26: 175 commitsWeek of 2026-08-02: 55 commitsWeek of 2026-08-09: 117 commitsWeek of 2026-08-16: 83 commitsWeek of 2026-08-23: 57 commitsWeek of 2026-08-30: 90 commitsWeek of 2026-09-06: 99 commitsWeek of 2026-09-13: 91 commitsWeek of 2026-09-20: 10 commitsWeek of 2026-09-27: 65 commitsWeek of 2026-10-04: 156 commitsWeek of 2026-10-11: 52 commitsWeek of 2026-10-18: 84 commitsWeek of 2026-10-25: 51 commitsWeek of 2026-11-01: 72 commitsWeek of 2026-11-08: 415 commitsWeek of 2026-11-15: 7 commitsNov 23, 2025Nov 15, 2026
2.8K commits in the last 52 weeks.

When work happens

weekday and hour
SunMonTueWedThuFriSat036912151821Sun 0:00 — 4 commitsSun 1:00 — 10 commitsSun 2:00 — 5 commitsSun 3:00 — 2 commitsSun 4:00 — 1 commitsSun 5:00 — 1 commitsSun 6:00 — 4 commitsSun 7:00 — 0 commitsSun 8:00 — 2 commitsSun 9:00 — 1 commitsSun 10:00 — 2 commitsSun 11:00 — 7 commitsSun 12:00 — 13 commitsSun 13:00 — 19 commitsSun 14:00 — 17 commitsSun 15:00 — 20 commitsSun 16:00 — 19 commitsSun 17:00 — 22 commitsSun 18:00 — 44 commitsSun 19:00 — 35 commitsSun 20:00 — 30 commitsSun 21:00 — 47 commitsSun 22:00 — 15 commitsSun 23:00 — 28 commitsMon 0:00 — 14 commitsMon 1:00 — 11 commitsMon 2:00 — 10 commitsMon 3:00 — 11 commitsMon 4:00 — 7 commitsMon 5:00 — 16 commitsMon 6:00 — 6 commitsMon 7:00 — 3 commitsMon 8:00 — 6 commitsMon 9:00 — 15 commitsMon 10:00 — 43 commitsMon 11:00 — 29 commitsMon 12:00 — 22 commitsMon 13:00 — 35 commitsMon 14:00 — 29 commitsMon 15:00 — 39 commitsMon 16:00 — 34 commitsMon 17:00 — 30 commitsMon 18:00 — 33 commitsMon 19:00 — 21 commitsMon 20:00 — 10 commitsMon 21:00 — 28 commitsMon 22:00 — 24 commitsMon 23:00 — 24 commitsTue 0:00 — 27 commitsTue 1:00 — 27 commitsTue 2:00 — 17 commitsTue 3:00 — 14 commitsTue 4:00 — 14 commitsTue 5:00 — 3 commitsTue 6:00 — 5 commitsTue 7:00 — 5 commitsTue 8:00 — 9 commitsTue 9:00 — 12 commitsTue 10:00 — 23 commitsTue 11:00 — 16 commitsTue 12:00 — 8 commitsTue 13:00 — 16 commitsTue 14:00 — 49 commitsTue 15:00 — 39 commitsTue 16:00 — 37 commitsTue 17:00 — 39 commitsTue 18:00 — 31 commitsTue 19:00 — 21 commitsTue 20:00 — 15 commitsTue 21:00 — 7 commitsTue 22:00 — 17 commitsTue 23:00 — 16 commitsWed 0:00 — 24 commitsWed 1:00 — 10 commitsWed 2:00 — 5 commitsWed 3:00 — 2 commitsWed 4:00 — 0 commitsWed 5:00 — 11 commitsWed 6:00 — 3 commitsWed 7:00 — 8 commitsWed 8:00 — 6 commitsWed 9:00 — 29 commitsWed 10:00 — 41 commitsWed 11:00 — 33 commitsWed 12:00 — 19 commitsWed 13:00 — 23 commitsWed 14:00 — 39 commitsWed 15:00 — 24 commitsWed 16:00 — 25 commitsWed 17:00 — 18 commitsWed 18:00 — 25 commitsWed 19:00 — 24 commitsWed 20:00 — 23 commitsWed 21:00 — 17 commitsWed 22:00 — 24 commitsWed 23:00 — 20 commitsThu 0:00 — 12 commitsThu 1:00 — 17 commitsThu 2:00 — 11 commitsThu 3:00 — 8 commitsThu 4:00 — 4 commitsThu 5:00 — 5 commitsThu 6:00 — 2 commitsThu 7:00 — 3 commitsThu 8:00 — 15 commitsThu 9:00 — 18 commitsThu 10:00 — 23 commitsThu 11:00 — 30 commitsThu 12:00 — 9 commitsThu 13:00 — 22 commitsThu 14:00 — 13 commitsThu 15:00 — 19 commitsThu 16:00 — 17 commitsThu 17:00 — 19 commitsThu 18:00 — 11 commitsThu 19:00 — 17 commitsThu 20:00 — 28 commitsThu 21:00 — 20 commitsThu 22:00 — 14 commitsThu 23:00 — 19 commitsFri 0:00 — 24 commitsFri 1:00 — 16 commitsFri 2:00 — 11 commitsFri 3:00 — 6 commitsFri 4:00 — 7 commitsFri 5:00 — 6 commitsFri 6:00 — 2 commitsFri 7:00 — 5 commitsFri 8:00 — 9 commitsFri 9:00 — 22 commitsFri 10:00 — 22 commitsFri 11:00 — 15 commitsFri 12:00 — 22 commitsFri 13:00 — 30 commitsFri 14:00 — 19 commitsFri 15:00 — 23 commitsFri 16:00 — 24 commitsFri 17:00 — 37 commitsFri 18:00 — 35 commitsFri 19:00 — 25 commitsFri 20:00 — 7 commitsFri 21:00 — 14 commitsFri 22:00 — 12 commitsFri 23:00 — 31 commitsSat 0:00 — 23 commitsSat 1:00 — 10 commitsSat 2:00 — 6 commitsSat 3:00 — 14 commitsSat 4:00 — 5 commitsSat 5:00 — 8 commitsSat 6:00 — 6 commitsSat 7:00 — 7 commitsSat 8:00 — 2 commitsSat 9:00 — 3 commitsSat 10:00 — 4 commitsSat 11:00 — 9 commitsSat 12:00 — 3 commitsSat 13:00 — 3 commitsSat 14:00 — 13 commitsSat 15:00 — 8 commitsSat 16:00 — 11 commitsSat 17:00 — 18 commitsSat 18:00 — 19 commitsSat 19:00 — 32 commitsSat 20:00 — 14 commitsSat 21:00 — 17 commitsSat 22:00 — 12 commitsSat 23:00 — 6 commits
Commit volume by weekday and hour (UTC). Larger dots mean more commits.

Who is committing

last 52 weeks
Maintainer commits2,502 (76%)
Community commits789 (24%)

3,291 commits in total over the last year.

DateListRankStars gained
Nov 21, 2026monthly#8+30,843
Nov 20, 2026monthly#8+30,843
Nov 19, 2026monthly#8+30,662
Nov 18, 2026monthly#6+30,177
Nov 17, 2026monthly#5+29,881
Nov 16, 2026monthly#5+29,631
Nov 15, 2026monthly#5+29,487
Nov 14, 2026monthly#5+29,328
Nov 13, 2026monthly#5+29,165
Nov 12, 2026monthly#5+28,902
Nov 11, 2026monthly#6+28,598
Nov 10, 2026monthly#7+28,285
Nov 9, 2026monthly#7+28,008
Nov 8, 2026weekly#10+8,172
Nov 8, 2026monthly#8+27,680
  • morluto/rea

    Reverse engineer anything with agents, from app behavior down to native binaries.

    471.6K stars · TypeScript

  • openclaw/openclaw

    The AI that really does things. Any OS. Any Platform. The lobster way. 🦞

    394.9K stars · TypeScript

  • donnemartin/system-design-primer

    Learn how to design large-scale systems. Prep for the system design interview. Includes Anki flashcards.

    378.7K stars · Python

  • obra/superpowers

    An agentic skills framework & software development methodology that works.

    322.9K stars · Shell

  • NousResearch/hermes-agent

    The agent that grows with you

    265K stars · Python

  • n8n-io/n8n

    Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

    211.6K stars · TypeScript