repowisepbakaus/impeccable

pbakaus / impeccable

The design language that makes your AI harness better at design.

Rust★ 86,622
Use in your agentAsk this codebase

github.com/pbakaus/impeccableIndexed at 9368675Up to date with upstream

What is impeccable?

impeccable is design guidance for AI coding agents, aimed at the visual quality of AI-generated frontend interfaces. It provides 1 skill, 24 commands, and 62 deterministic detector rules that flag common generic design patterns, and the CLI and browser extension run those rules without an LLM or API key. The project's primary language is Rust.

Written by a model from the README and the source

3,590 files and 32,360 symbols in 29 modules, led by Rust (423 files) and JavaScript (371).

Start reading

Code health

2.7out of 10At risk

Hotspots average 1.8, the place fixes pay off most.

Full health report

On the leaderboards:#15 of 15 Rust repos

Use pbakaus/impeccable in your agent

Point Claude Code, Cursor, Codex or VS Code at this repository. Your agent gets the index this page is built from: cited answers, callers, history and health for any file.

  1. 1.In Claude, open Customize → Connectors, click +, then Add custom connector. On a Team or Enterprise plan an owner adds it first under Organization settings → Connectors.
  2. 2.Paste the server URL below as the Remote MCP server URL, then click Add.
  3. 3.Click Connect. A Repowise sign-in window opens. Approve access.
  4. 4.Repowise's tools are now available in your Claude chats.

Connect with one click. Sign in with Repowise (OAuth), no API key to copy. Works in Claude on the web, desktop, and mobile.

Docs
bash
https://api.repowise.dev/mcp/pbakaus/impeccable
Editors need an API key: sign in to create one.Sign in to connect

This repo is public, so anyone with a Repowise account and an API key can connect.

Try asking

  • get_overview()
  • get_answer("how is impeccable put together?")
  • get_why("why is impeccable structured this way?")

Explore impeccable

Key features of impeccable

  • A single setup flow, /impeccable init, records durable product facts in PRODUCT.md so later commands know the audience, purpose and constraints.
  • 24 commands give the AI agent a shared design vocabulary, including polish, audit, critique, distill, animate, bolder and quieter.
  • 62 deterministic detector rules run in the CLI and browser extension with no LLM and no API key.
  • A design hook surfaces detector findings back into the agent flow after direct UI file edits on supported tools.
  • The installer supports Cursor, Claude Code, Gemini CLI, Codex CLI, Grok Build, Hermes Agent, Veto and other supported tools.

How pbakaus/impeccable works

Users invoke the single /impeccable skill, whose main definition is .agent/skills/impeccable/SKILL.md, with per-topic guides in the reference directory such as adapt.md and animate.md. Each installed copy includes a launcher, scripts/impeccable, which runs the Impeccable engine binary. The Rust CLI starts from crates/cli/src/main.rs, while cli/bin/cli.js is the Node entry point used by the npx installer. crates/browser/src/lib.rs is the entry point for the browser module that checks rendered pages, and crates/bundle/src/lib.rs is the entry point for the bundle crate. On supported tools, the design hook runs the detector on direct UI file edits and returns findings to the agent.

The codebase has 3,590 files and 32,360 symbols in 29 modules, led by Rust, JavaScript and TypeScript. Code health is 2.7 out of 10, rated at risk.

Getting started with impeccable

  1. From your project root, install the skill with the CLI installer.
    npx impeccable install
  2. In your AI coding tool, run a command against a specific area of the interface.
    /impeccable audit the header
  3. To refresh an existing install, run the update command.
    npx impeccable update

Commands copied from the README

pbakaus/impeccable FAQ

What is impeccable?

impeccable is design guidance for AI coding agents that targets AI-generated frontend design. It bundles 1 skill, 24 commands, and 62 deterministic detector rules.

How does impeccable work?

impeccable adds the /impeccable skill to your AI coding tool and runs its commands through the agent. On supported tools, a hook runs the detector on UI file edits and returns findings to the agent.

How do I install impeccable?

impeccable installs with npx impeccable install from the project root, and npx impeccable update refreshes an existing install. Reload your harness after installing.

What language is impeccable written in?

impeccable is primarily written in Rust. The repository also contains JavaScript and TypeScript files.

How is the impeccable code organized?

impeccable keeps most of its Rust code in the crates directory, with entry points in crates/cli/src/main.rs and crates/browser/src/lib.rs. Other top-level directories include tests, scripts and ui.

Who is impeccable for?

impeccable is for developers who use AI coding agents to build frontend interfaces and want those agents to avoid common generic design patterns. It is aimed at AI-generated frontend design.

What license does impeccable use?

impeccable is licensed under Apache-2.0.

The summary, features and answers on this page are written by a model from the README and the source, and refreshed with each index.

About this page

Get a page like this for your own codebase

Repowise built this map of pbakaus/impeccable from its source and git history. It parses every symbol, draws the dependency graph, scores each file's health from complexity, duplication, coverage and churn, finds hotspots and owners in the history, and writes documentation for every module. Your coding agent reads the same index over MCP, so its answers cite real files.

Index your repo freeSee how Repowise worksFree for 2 public repos, with a page like this one.

Prefer local? pip install repowise && repowise init indexes your own checkout, no account needed.