用途：将 Impeccable 的 /impeccable 技能与设计 hook 安装进项目自身的 AI harness 作用域，而非写入本机全局目录。会生成各 provider 目录下的技能文件夹（如 .claude/skills/impeccable/、.cursor/skills/impeccable/）、impeccable-*.md agent 文件，以及可选的 hook manifest。
两个安装陷阱：其一，当前 npm 发布版 impeccable@3.6.1 对 install 子命令未处理 --help，执行 npx impeccable install --help 会直接开始安装；其二，在无 TTY 的脚本、CI 或 agent 环境中提问返回空串并回落到默认作用域，机器上若已有 ~/.claude、~/.cursor 等目录，默认即为 global，Impeccable 会写入 $HOME 下 13 个目录。安全规则是非交互场景必须显式声明三项：npx impeccable install -y --scope=project --providers=claude。
安装方式一（推荐）：CLI installer。先 cd 到项目目录，然后执行 npx impeccable install -y --scope=project --providers=claude,cursor。可用参数包括 -y/--yes（接受默认并强制 project）、--scope=project|global、--project/--user/--global 简写、--providers 指定 provider 列表、--no-hooks 跳过 hook、--force 覆盖。技能包从 https://impeccable.style 下载，需要联网。
安装方式二：Git submodule。git submodule add https://github.com/pbakaus/impeccable .impeccable，再执行 npx impeccable link --source=.impeccable --providers=claude,cursor，提交 .gitmodules 与相关目录；更新用 git submodule update --remote .impeccable 后重新 link。
安装方式三：插件，仅 Claude Code 与 Grok Build。Claude Code 用 /plugin marketplace add pbakaus/impeccable；Grok Build 用 grok plugin install pbakaus/impeccable#plugin --trust。
检查与更新：npx impeccable check 输出技能包版本；npx impeccable update -y --scope=project 执行更新。CLI 版本（npm 3.6.1）与技能包版本（从 impeccable.style 下载，如 4.1.3）相互独立。update --help 同样会直接执行更新，不要使用。
Hook：install/update 在未加 --no-hooks 时按 provider 写入 hook manifest，涉及 Claude Code、Cursor、Codex、GitHub Copilot、Grok Build 等，各自指定 manifest 文件与执行脚本。Codex 安装后需在 /hooks 中审批项目 hook，且内容变化后需重新审批；Grok Build 需信任目录（/hooks-trust 或 --trust）。安装后可用 hook-admin.mjs 的 status/off/on/reset 子命令启停 hook，无需重装。
.gitignore：.impeccable/ 下部分文件应提交（config.json、live/config.json、design.json、surfaces/.md、critique/.md），临时与按开发者区分的文件应忽略，文档给出了完整的忽略块。
卸载：无 uninstall 命令，需手动删除。全局误装时需清理 13 个 provider 的 skills/impeccable 目录及 ~/.claude/agents、~/.cursor/agents 下的 impeccable-*.md，文档提供了检查脚本与删除命令；project 作用域只需删除项目内对应目录与 hook manifest。另注：若设置 $OPENCODE_CONFIG_DIR，OpenCode 会通过该路径而非 ~/.opencode 识别。
后续步骤：安装后在 AI coding agent 的聊天中输入 /impeccable init（终端中执行会被有意拦截并返回错误），具体 init 与 23 个聊天命令见单独文档。适用场景：需要将 Impeccable 设计技能固定到具体项目、希望以项目为单位共享配置的团队。限制：文档未说明该技能具体设计能力、收费与价格信息，暂未提供。