Impeccable

What Impeccable does

Impeccable is the frontend design skill from pbakaus/impeccable, repackaged for Hermes Agent. It covers planning a feature before code is written, critiquing and auditing a UI, and refining it with commands such as polish, harden, animate and typeset. A mechanical anti-pattern detector backs the design advice, and a live mode lets you pick elements in the browser and iterate on variants.

This repository tracks upstream's generated Hermes build release by release, with the pinned tag recorded in an UPSTREAM file. It adds a small Hermes overlay: metadata.hermes tags and related skills, a description that leads with its routing signal because the Hermes skill index keeps only the first 57 characters, and a setup note that resolves scripts/impeccable from the skill_dir returned by skill_view and runs it through sh. The first command that needs the engine downloads a self-contained binary from upstream's GitHub releases, verifies its checksum and caches it in ~/.impeccable.

Key features

• Commands grouped as Build, Evaluate, Refine, Enhance, Fix, Iterate and Maintain, including init, shape, critique, audit, polish, harden, live and doctor
• Mechanical anti-pattern detector for UI code
• Four design modes: Persuade, Operate, Read and Experience
• Captures product context in PRODUCT.md and generates DESIGN.md from existing project code
• Engine binary is downloaded once, checksum-verified and cached, with no Node required

When to use it

• Reviewing a checkout page or dashboard with an audit or critique command
• Planning the UX of a new feature before any code is written
• Running a final polish pass on a UI before shipping
• Pulling reusable tokens and components into a design system

Who it is for: Developers and designers who ask Hermes Agent to build or review web UI and want a structured design workflow.

How it fits with Hermes Agent

A skill packaged for Hermes Agent and installed under ~/.hermes/skills/creative/impeccable, with Hermes-specific metadata and path handling added over the upstream build.

How to install Impeccable

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

dest="${HERMES_HOME:-$HOME/.hermes}/skills/creative/impeccable"
git clone https://github.com/DevvGwardo/impeccable /tmp/impeccable
mkdir -p "$dest" && cp -R /tmp/impeccable/{SKILL.md,reference,scripts} "$dest/"

Requirements: Hermes Agent and network access on first use to download the engine binary from upstream's GitHub releases; no Node required

Note: This is a Hermes packaging of the upstream pbakaus/impeccable skill, not the original project.

FAQ