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/.

<details> <summary><b>Claude Code, Copilot, and Grok plugins</b></summary>

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.

</details> <details> <summary><b>Git submodule (a pinned version for the whole team)</b></summary>

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.

</details> <details> <summary><b>Manual copy, no Node required</b></summary>

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.

</details>