Impeccable スキル:24 のデザインコマンドと 62 の検出ルール

pbakaus/impeccable はコーディングエージェントのためのデザイン語彙。24 のコマンド、hook・CLI・Chrome 拡張で走る 62 の決定論的ルール、Claude Code と DeepSeek Harness の導入手順、エンジンバイナリを外した dsh コミュニティ移植版まで。

最終更新: 2026-11-19

先に結論

impeccable はコーディングエージェント向けのデザインスキルです。「どのデザイン操作をしてほしいか」を伝えるコマンドの語彙と、AI っぽさの正体に名前を付ける検出器の組み合わせ。リポジトリの説明は一文だけ:「The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, and catch AI slop before it ships.」

実際に導入するものは3つで構成されています。

  • /impeccable — 入口のコマンド。単独で打つとコマンド一覧が出ます。
  • その背後の 24 のコマンド:23 の名前付きプレイブックと、README が「a deprecated alias for a plain build request」と説明する craft。
  • 検出器の 62 の決定論的ルール — README の表現で「No LLM, no API key」。

作者は Paul Bakaus、ライセンスは Apache-2.0。README には「started from Anthropic's frontend-design skill」と書かれています。2026-11-19 の GitHub API スナップショットでは 112,991 stars、6,730 forks、作成 2025-11-16、最終 push 2026-11-18。これらはスナップショットの値で、固定値ではありません。

以下の内容はすべて 2026-11-19 に読んだもので、コマンドは README と移植版のファイルからの逐字引用です。「画面1枚を作り直す」ことが目的でコマンドの語彙が要らないなら、unslop スキルのほうが近道です。

24 のコマンド

README の表の見出しはそのまま「### 24 commands」で、何をするかでグループ分けされています。コマンド名は逐字:

グループコマンド
Steerbolder、quieter、distill、colorize、typeset、layout、animate、delight、overdrive
Reviewcritique(採点付き UX レビュー)、audit(技術品質レポート)
Finishpolish、harden、clarify、adapt、optimize、onboard
Iterate livelive、generate
Plan and set upshape、init、document、extract

名前付きは 23 個。24 個目はその次の行にあります。README の原文:「The 24th, craft, is a deprecated alias for a plain build request.」各コマンドには専用のドキュメントページがあります(impeccable.style/docs)。

最初に走らせるべきはコンテキストを作る2つで、他のコマンドはその成果物を読みます。init は PRODUCT.md を書きます。README いわく「reads your code, asks only what it can't infer (who the product is for, what it needs to do, the constraints)」。document は既存の視覚体系を DESIGN.md に写し取り、以降の変更が「stay on-brand」になるようにします。作業ファイルはプロジェクトの .impeccable/ に置かれます。

コマンドには対象を渡します。対象は狭いほど結果が良くなります:/impeccable critique the onboarding flow、/impeccable quieter the landing page、/impeccable polish settings、/impeccable harden checkout。Codex ではスラッシュコマンドではなく /skills か $impeccable を使います。/impeccable pin audit でよく使うコマンドに /audit というショートカットを与えられます。README にはこの機能がありますが、dsh 移植版では外されています(後述)。

live はブラウザ内のループです。README いわく「opens your running dev server with an overlay. Select an element, pick a direction, and Impeccable hot-swaps variants in place」。Vite、Next、SvelteKit、Astro、Nuxt、素の HTML で動き、ローカルの checkout だけを編集します。

検出器:62 のルール、3つの走らせ方

README の原文:「A slop detector. 62 deterministic rules flag the tells above, plus quality problems like cramped padding and skipped headings. No LLM, no API key.」slop ページも同じ数え方です:「The catalog includes 62 detector rules and 6 patterns for design review.」

**エージェント内。**design hook は「scans every UI file your agent edits and hands the findings back before the agent calls the work done」。対象範囲は README が明示しています:「It's available on Claude Code, Cursor, Codex, GitHub Copilot, Grok Build, and Hermes Agent, and the installer sets it up.」このリストに dsh はありません — 後述の DeepSeek Harness の節を参照。

**ターミナルや CI で。**CLI はエージェント不要です。

npx impeccable detect src/                   # ディレクトリを走査
npx impeccable detect https://example.com    # レンダリング後のページを走査(手元の Chrome か Edge を使用)
npx impeccable detect --json .               # 機械可読な出力
npx impeccable detect --github src/          # GitHub Actions のアノテーション
npx impeccable detect --sarif src/           # code scanning 用の SARIF 2.1.0
npx impeccable detect --list-rules           # 全ルールの id と説明
npx impeccable detect --report-unused-ignores src/  # 何も免除していないインライン ignore を洗い出す

JSX や TSX のようなソースファイルではパターン系のルールだけが走ります。低コントラストや小さすぎる文字のように、レンダリングされたページが必要なルールは URL を走査したときだけ動くので、dev サーバーも指定します:npx impeccable detect http://localhost:5173。

終了コード 0 はクリーン、2 は指摘あり、1 は走査できない対象があったという意味です。ルール id はその後の調整の取っ手になります。検出器のドキュメントが指摘例として使っているのが overused-font と gradient-text。黙らせる方法は2つ:

npx impeccable ignores add-value overused-font Inter --reason "Brand font"
<!-- impeccable-disable overused-font: exported brand doc -->

1つ目はブランドフォントを全体で許可し、2つ目は1ファイルだけルールを切ります。

ブラウザで。Chrome 拡張は同じ指摘を、自分のものでも他人のものでも任意の公開ページに重ねます。

インストール

プロジェクトのルートで:

npx impeccable install

インストーラは手元のコーディングツールを検出し、このプロジェクト向けかグローバルかを尋ね、対応ツールでは design hook を提案します。更新は npx impeccable update。スクリプトからは --providers=claude,codex,cursor と --scope=project|global を渡します。

README によると、3つのツールは hook が動く前に追加の手順が要ります。Codex では /hooks を開いてプロジェクト hook を承認(hook が変わる更新の後にもう一度)。Grok Build では /hooks-trust を実行するか --trust 付きで起動。Hermes Agent では hermes plugins enable impeccable-design-hook を一度実行します。

Claude Code にはプラグイン経路もあります。/plugin marketplace add pbakaus/impeccable の後に /plugin を開いて Impeccable をインストール。導入後にツールを再読み込みし、エージェントで /impeccable init(Codex では $impeccable init)を実行します。チームでバージョンを固定するならサブモジュール経路があります:git submodule add でこのリポジトリを追加し、npx impeccable link --source=vendor/impeccable --providers=claude,cursor を実行します。link はスキルだけを入れ、hook は入れません。

Node が無くても大丈夫です。README には手動コピーの表があり、そこに DeepSeek Harness の行があります:

ツールリポジトリ内フォルダグローバルのスキルフォルダ
DeepSeek Harness.dsh/${DSH_HOME:-$HOME/.dsh}/skills/

つまり skills/impeccable をプロジェクトの .dsh/skills/ へ、またはグローバルのフォルダへコピーします。上流リポジトリの main ツリーには実際に .dsh/skills/impeccable/(SKILL.md、reference/ 配下の 50 個の markdown、ランチャーと live-browser-*.js、フォント索引を収めた scripts/)がコミットされているので、コピーするのはこれです。

同じ表に dsh で効いてくる注記があります:「impeccable install and update manage a DeepSeek Harness global copy only when DSH_HOME is inside your home directory.」DSH_HOME がホームディレクトリの外を指しているなら、グローバル側は自分でコピーします。

Node は npx のためだけに必要です。スキル本体は「a self-contained engine binary that ships next to it or downloads once into ~/.impeccable/bin/」を動かします。だからこそ手動コピーは完全なインストールではありません:「A manual copy skips the design hook and subagents.」

DeepSeek Harness と一緒に使う

次の2つはセットで読む必要があります。dsh の状況はこの2点に尽きます。

  1. **DeepSeek Harness は公式の対応リストに入っています。**README の対応リストは逐字で:「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.」手動コピーの表に dsh の行があり、リポジトリには .dsh/skills/impeccable/ もコミットされています。
  2. **編集後の自動検出 hook は dsh では使えません。**hook の対象は Claude Code、Cursor、Codex、GitHub Copilot、Grok Build、Hermes Agent のみ。dsh では検出は自分で打つコマンドです:npx impeccable detect src/、あるいはレンダリング前提のルールのために dev サーバーを指定します。

これが「対応している」と「全部つながっている」の実際の差です。コマンド、参照ファイル、コンテキストファイル(PRODUCT.md、DESIGN.md)は同じように動きます。編集のたびに自動で受け止めてくれる層だけがありません。手で入れる場合、.dsh/skills/ の構成はスキルの導入に、コピーが前提にしているフォルダの形はスキルとは何かにあります。

dsh コミュニティ移植版

上流スキルがエンジンバイナリを要求するため、dsh ネイティブ版が作られています:kechao-sgp/dsh-impeccable-skill。これはコミュニティ移植であり、上流のリリースでも DeepSeek 公式でもありません。NOTICE に「not published, endorsed, or supported by the upstream author」と明記されています。

リポジトリの実態は次のとおりです。

  • 同梱の impeccable スキルを登録する。index.js はパッケージ内の skill/SKILL.md を一度読んで登録するだけ(source: bundled)。Node の組み込みモジュールのみを使い、ファイルを書かず、子プロセスを起こさず、ツールやスラッシュコマンドも登録しません。package.json は dsh.capabilities: ["fs:read"] を宣言しています。
  • **README のプレイブック表は 23、スキル内のコマンド表は 24。**README の表は計画・レビュー・仕上げ・強化・修正・反復でグループ分けされ、合計 23 の名前付きプレイブック。スキル自身のコマンド表は craft(原文「Deprecated alias for an ordinary new-work request」)も載せており、ここで 24 になります。skill/reference/ に 46 個の .md(うち degraded/ が 4、*.native.md が 2、mode-*.md が 3)。加えて craft-floor.md、new-work.md、region-map.md、routing.md、dsh-runtime.md。
  • **エンジンバイナリを含まない。**README の原文:「本移植版不打包该二进制:来源不可审计、体积与本插件定位不符。」代わりに skill/reference/dsh-runtime.md が各エンジンコマンドを dsh ネイティブの操作に対応づけます:impeccable context → PRODUCT.md / DESIGN.md / .impeccable/ を直接読む、detect → 手作業の走査(craft-floor の禁止事項 + grep + コンテキストを1行ずつ読む)、generate-image → dsh ネイティブの generate_image、スクリーンショット → playwright スキル・コミット済みの視覚ベースライン・ユーザーのスクリーンショット、comp-spec → 画像を見て regions.json を手書きし寸法は推定と明記、font-match → 目視で最も近い入手可能なフォントを選び推定と宣言、live → 静的なバリアントファイルとスクリーンショットに落としてユーザーに選ばせる、フック → なし。
  • 明示された3つの制限。SKILL.md に「Edition limits」の節があります。Pin/Unpin は使えない。hooks は走らないので、自分の編集後にアンチパターンの手作業チェックを行い、そう述べる。Doctor に自動修復は無く、doctor.md のチェックリストを手で辿る。
  • **3つの導入経路。**リポジトリから(パッケージが dsh.bundle を宣言しているのでリポジトリの URL をプラグイン管理に貼る)— README は「当前可用」と記載。ローカルディレクトリから(開発・デバッグ用)。マーケットから — README は「待收录」と記載。npm パッケージ dsh-impeccable-skill は未公開で、2026-11-19 に https://registry.npmjs.org/dsh-impeccable-skill は HTTP 404 を返し、README の記述と一致します。
  • **同名の衝突。**npm には別に Cassius0924 の dsh-impeccable(最新 0.1.2、2026-10-31 公開、23 のデザインプレイブックと自称)があり、クライアント側のワークベンチと検出器を備えます。移植版 README は両者が同じスキル名を登録すると警告しています:「两者都注册同名技能 impeccable,不要同时安装(同层同名先到先得,后装的不生效)。」

ライセンス:スキル本文と skill/reference/ は pbakaus/impeccable(Apache-2.0)由来、reference/ios.md と reference/android.md は ehmo/platform-design-skills(MIT)由来。移植版が同梱する上流スキルは 4.8.0 で、「re-checked against the repository on 2026-11-07」。一方 2026-11-19 に上流自身の .dsh SKILL.md を読むと version: 4.10.0 でした。つまり移植版の内容は上流の現在のバージョンより遅れています。

ディレクトリ側の事実は、このサイトで何が読めるかを決めます。kechao-sgp/dsh-impeccable-skill は当サイトのカタログに収録済みで、分類はエコシステム & リソース。2026-11-19 のスナップショットは 0 stars / 0 forks、作成も最終 push も 2026-11-07。まだ専用の詳細ページが無いので、入口は「impeccable」でのディレクトリ検索です。同じ検索結果の zc7hyz/dsh-taste は自身の README でスキャナを「25 条设计方法论 + 61 条确定性反模式扫描器」と説明していますが、これはそのプロジェクト自身のツールについての自己申告であり、上流の 62 ルールとは別の数え方です。

Impeccable と unslop の役割分担

どちらもデザインスキルですが、互換ではありません。分け方は単純です。

  • Impeccable はコマンドの語彙 + 検出器 + コンテキストファイル。24 のコマンドで方向を指し、62 のルールで結果を確認し、PRODUCT.md と DESIGN.md でセッションをまたいで同じ審美を保ちます。既に存在するインターフェースに最も強く、README も「point it at a page or a component and iterate」と書いています。
  • unslop スキル は画面1枚のための単一プレイブック。スロップを列挙し、プロダクトから方向性を決め、決まった順序でパスごとに直し、最後に短い動画も撮れます。

再利用できるコマンド語彙と CI に載せられる検出器が欲しいなら Impeccable。vibecoded なページを一通り作り直したいなら unslop。両者は共存できます(名前もスキルも別)が、同じセッションで同じ画面に両方を走らせると作業が重複するだけです。広い比較は導入すべき dsh スキルと pstack スキルへ。

向かない場面

  • **直したいのが文章で、画面ではない。**Impeccable には UI 内の分かりにくいコピーを直す clarify がありますが、文章全体のスロップ除去は別の仕事です。humanizer スキルを参照。
  • 欲しいのがセキュリティや正当性の監査。audit はデザイン品質のレポートで、アクセシビリティ、パフォーマンス、テーマ、レスポンシブが対象です。コード監査ではありません。
  • **dsh で hook が自動で走るのを待っている。**dsh では勝手には動きません。npx impeccable detect を走らせる時間を確保するか、編集後に誰も確認しないことを受け入れます。
  • **エンジンバイナリをどうしても動かせない。**上流スキルはこれに依存します。手動コピーでは hook もサブエージェントも付かず、コミュニティ移植ではプレイブック本文と手作業の代替手順だけが得られ、エンジンの計測はありません。
  • **ピクセル単位の正確な計測が必要。**移植版では comp-spec と font-match が明示された推定に降格します。正確な数値が要るなら、このツールではありません。

FAQ

Impeccable スキルとは何ですか? コーディングエージェント向けのデザインスキルで、作者は Paul Bakaus、ライセンスは Apache-2.0 です。リポジトリの説明は「the design vocabulary for your coding agent」:/impeccable という入口のコマンドに 24 のコマンド(23 の名前付きプレイブックと、通常のビルド要求に対する非推奨の別名 craft)、さらに LLM も API キーも使わない 62 の決定論的ルールからなるスロップ検出器が付きます。

Claude Code への入れ方は? プロジェクトのルートで npx impeccable install を実行します。インストーラは手元のコーディングツールを検出し、このプロジェクト向けかグローバルかを尋ね、design hook を提案します。プラグイン経由なら /plugin marketplace add pbakaus/impeccable の後に /plugin を開いて Impeccable をインストール。ツールを再読み込みしてから、エージェントで /impeccable init を実行します。更新は npx impeccable update。

DeepSeek Harness でも使えますか? 使えます。README の対応リストに DeepSeek Harness があり、手動コピーの表にも dsh の行(リポジトリ内 .dsh/、グローバル ${DSH_HOME:-$HOME/.dsh}/skills/)があります。ただし編集後に自動検出する hook は Claude Code、Cursor、Codex、GitHub Copilot、Grok Build、Hermes Agent のみで、dsh は対象外です。dsh では npx impeccable detect を自分で実行します。

62 のルールはどう走らせますか? 3通りです。エージェント内では design hook が編集した UI ファイルを走査します。ターミナルや CI では npx impeccable detect src/ でディレクトリを、npx impeccable detect https://example.com でレンダリング後のページを走査し、--json・--github・--sarif・--list-rules・--report-unused-ignores で出力を変えられます。ブラウザでは Chrome 拡張が同じ指摘を任意の公開ページに重ねます。終了コード 0 はクリーン、2 は指摘あり、1 は走査できない対象があったという意味です。

DeepSeek Harness 向けの移植版はありますか? コミュニティ製のものがあります。kechao-sgp/dsh-impeccable-skill はプレイブックと 46 の参照ファイルを同梱の impeccable スキルとして提供し、エンジンバイナリを含みません。dsh-runtime.md が各エンジンコマンドを dsh ネイティブの操作に対応づけます。Apache-2.0 のコミュニティ移植で、上流公式でも dsh 公式でもありません。2026-11-19 時点のスナップショットは 0 stars / 0 forks、npm パッケージは未公開で registry は 404 を返します。同名スキルを登録する dsh-impeccable とは併用しないでください。

Sources

以下の記述はすべて 2026-11-19 に読んだものです。

  • github.com/pbakaus/impeccable — README:一文の説明、DeepSeek Harness を含む対応リスト、「### 24 commands」の表と craft の非推奨別名、62 ルールの一文、hook の対象リストと3ツールの追加承認手順、7 つの detect 呼び出し、終了コード、ignores と impeccable-disable の書き方、--providers / --scope 付きの install と update、Claude Code の /plugin marketplace add 経路、サブモジュール経路、.dsh/ と ${DSH_HOME:-$HOME/.dsh}/skills/ の行を含む手動コピー表、DSH_HOME の注記、「Node is only needed for npx」と ~/.impeccable/bin/ の説明、「manual copy skips the design hook and subagents」、live モードの説明、.impeccable/ のプロジェクトファイル、ライセンスの記述(「Apache 2.0. See LICENSE. Impeccable started from Anthropic's frontend-design skill.」)。2026-11-19 に読んだリポジトリツリー:.dsh/skills/impeccable/ に SKILL.md(version: 4.10.0)、reference/ の 50 個の markdown、ランチャーと live-browser-*.js、フォント索引を収めた scripts/。2026-11-19 取得の GitHub API スナップショット:Apache-2.0、112,991 stars、6,730 forks、created 2025-11-16、pushed 2026-11-18(スナップショットであり固定値ではありません)。
  • impeccable.style/slop — 「The catalog includes 62 detector rules and 6 patterns for design review.」
  • impeccable.style/docs/detector — 終了コードの表(0 / 2 / 1)、overused-font と gradient-text の指摘例、無視設定の例で使われているルール id。
  • github.com/kechao-sgp/dsh-impeccable-skill — README、NOTICE.md、skill/SKILL.md、index.js:登録される impeccable スキルと index.js の挙動、README の 23 プレイブック表とスキル内コマンド表の craft 行、dsh-runtime.md のコマンド対応表、「Edition limits」、3 つの導入経路、dsh-impeccable との同名衝突、Apache-2.0 と MIT の出所、同梱する上流 4.8.0、「not published, endorsed, or supported」の一文。2026-11-19 に読んだリポジトリツリー:skill/reference/ 配下に 46 個の .md(degraded/ が 4、*.native.md が 2、mode-*.md が 3)。2026-11-19 の GitHub API スナップショット:Apache-2.0、0 stars、0 forks、created 2026-11-07、pushed 2026-11-07。
  • registry.npmjs.org/dsh-impeccable-skill — 2026-11-19 に HTTP 404。README の「npm 包 dsh-impeccable-skill 尚未发布」と一致。
  • registry.npmjs.org/dsh-impeccable — 別系統の Cassius0924 パッケージ:最新 0.1.2、2026-10-31 公開。

Impeccable は Paul Bakaus のオープンソースプロジェクト、dsh 移植版はコミュニティのパッケージです。どちらも DeepSeek の製品ではなく、当サイトとも関係ありません。コマンドは上記の日付時点の README に基づきます。このリポジトリは本稿の確認前日にも push されているため、実行前に再確認してください。

関連記事:unslop スキル、スキルの導入、スキルとは何か、導入すべき dsh スキル、pstack スキル。

DSH Plugins は DeepSeek Harness プラグインの独立したコミュニティ ディレクトリです。DeepSeek との提携・公認はありません。サードパーティ製プラグインはセキュリティ監査を受けていません。インストール前にソースコードをご確認ください。

DeepSeek Harnessの新着プラグインを毎週お届け。スパムはありません。