AIが作るUIデザインの「いつもの手抜き感」を撲滅する17のコマンド — impeccable

pbakaus/impeccableJavaScript3.3k

Impeccableは、AIコーディングアシスタント(Claude、Cursor、Geminiなど)が生成するWebデザインの品質を劇的に向上させるための「デザイン指示書」です。AIは学習データの偏りから、同じようなフォントや紫のグラデーション、カードの入れ子構造など、ありきたりで見慣れたデザインを繰り返しがちです。Impeccableは7つの専門分野の参考資料と17種類のコマンド、そして「やってはいけないこと」リストをAIに教え込むことで、AIの出力するデザインをプロレベルに引き上げます。例えるなら、AIに対してベテランデザイナーが横について常にアドバイスしてくれるようなものです。AIを使ってWebサイトやアプリを作る開発者・デザイナーにとって非常に便利なツールです。

🔥 なぜ話題?

AIコーディングツール(Cursor、Claude Code、Gemini CLIなど)でWebサイトを丸ごと作る開発スタイルが急速に普及する中、「AIが作るデザインがどれも似たり寄ったりで垢抜けない」という共通の課題に正面から取り組んだプロジェクトとして注目を集めています。Anthropic公式のfrontend-designスキルを拡張した実用性の高さと、17種類のコマンドという手軽さも話題の理由です。

💡 こう使える!

CursorやClaude CodeでWebサイトのランディングページを作っているとき、AIが生成したデザインが「どこかで見たような、無難すぎるデザイン」になってしまった場合、`/critique` コマンドでデザインの問題点を指摘させ、`/bolder` コマンドでもっとインパクトのあるデザインに仕上げ、最後に `/polish` コマンドで細部を整えることで、AIだけでプロ品質のデザインに到達できます。

ユースケース: AIコーディングツールで作成したWebサイトやアプリのデザインを、コマンド一つで専門家レベルに引き上げたい人向け。

  • 17種類のコマンドでデザインの監査・改善・調整が自在にできる
  • AIが陥りがちなデザインの「ありきたりパターン」を明示的に回避させる仕組み
  • Cursor、Claude Code、Gemini CLI、Codex CLIなど主要AIツールに対応
  • タイポグラフィ・色彩・アニメーション・レスポンシブなど7分野の専門知識を搭載
  • Apache 2.0ライセンスで商用利用も可能
GitHubで見る →

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

技術情報

言語

JavaScript

ライセンス

Apache-2.0

最終更新

2026-03-09

スター数

3,337

フォーク数

124

Issue数

10

技術詳細

アーキテクチャ・仕組み

Impeccableは、AIコーディングツールの「スキル」機能を活用するデザインガイドラインシステムです。Anthropicが公開した frontend-design スキル をベースに拡張されており、AIに対してデザインの専門知識とルールを事前に読み込ませることで、生成されるUI/UXの品質を向上させます。

7つの専門リファレンス

リファレンス内容
typographyタイプシステム、フォントペアリング、モジュラースケール、OpenType機能
color-and-contrastOKLCH色空間、色味付きニュートラル、ダークモード、アクセシビリティ
spatial-designスペーシングシステム、グリッド、視覚的階層
motion-designイージングカーブ、スタガリング、モーション軽減対応
interaction-designフォーム、フォーカス状態、ローディングパターン
responsive-designモバイルファースト、フルイドデザイン、コンテナクエリ
ux-writingボタンラベル、エラーメッセージ、空状態のコピー

17コマンドの分類

  • 初期設定: /teach-impeccable — プロジェクトのデザインコンテキストを収集して設定に保存
  • 品質チェック系: /audit(技術品質)、/critique(UXデザインレビュー)
  • 修正・調整系: /normalize(デザインシステム準拠)、/polish(最終仕上げ)、/distill(本質だけに絞る)、/clarify(UXコピー改善)
  • パフォーマンス系: /optimize(パフォーマンス改善)、/harden(エラーハンドリング、i18n、エッジケース)
  • 表現強化系: /animate(モーション追加)、/colorize(戦略的な色の導入)、/bolder(インパクト強化)、/quieter(トーンダウン)、/delight(喜びの演出追加)
  • 構造系: /extract(再利用可能コンポーネントへの分離)、/adapt(デバイス対応)、/onboard(オンボーディングフロー設計)

各コマンドはオプション引数で対象を絞り込める(例: /audit header/polish checkout-form)。

アンチパターン(明示的な禁止事項)

  • Arial、Inter、システムデフォルトなど使い古されたフォントの使用
  • 色付き背景にグレーテキストを置く
  • 純粋な黒/グレーの使用(必ず色味を加える)
  • すべてをカードで囲む、カードの中にカードを入れ子にする
  • バウンス/エラスティックイージングの使用(古臭く見える)

対応ツール

  • Cursor — Nightly チャンネル + Agent Skills有効化が必要
  • Claude Code — プロジェクト単位またはグローバルに設定可能
  • Gemini CLI — プレビュー版(@google/gemini-cli@preview)+ Skills有効化が必要
  • Codex CLI — コマンド構文が異なる(/prompts:audit 形式)

ライセンス・商用利用

  • Apache 2.0 ライセンス(商用利用可能)
  • Anthropicのオリジナルスキルをベースにしており、NOTICE.mdに帰属表示あり

制作者

Paul Bakaus が作成。ケーススタディは impeccable.style で確認可能。

インストール・クイックスタート

ウェブサイトからダウンロード(推奨)

impeccable.style からZIPをダウンロードして展開するだけ。

リポジトリから手動コピー

Cursor:

cp -r dist/cursor/.cursor your-project/

Cursor Nightly チャンネルへの切替と Agent Skills の有効化が必要

Claude Code:

# プロジェクト単位
cp -r dist/claude-code/.claude your-project/

# グローバル(全プロジェクト共通)
cp -r dist/claude-code/.claude/* ~/.claude/

Gemini CLI:

cp -r dist/gemini/.gemini your-project/

プレビュー版が必要: npm i -g @google/gemini-cli@preview

Codex CLI:

cp -r dist/codex/.codex/* ~/.codex/

使い方

/audit           # 問題点を発見
/normalize       # 不整合を修正
/polish          # 最終仕上げ
/distill         # 複雑さを除去

参考になる外部の関連記事

過去のトレンド履歴

関連リポジトリ

AIコーディングアシスタントを最強にチューニング!28エージェント×119スキルの包括的パフォーマンス最適化システム — everything-claude-code

affaan-m/everything-claude-codeJavaScript103.3k

everything-claude-codeは、Claude CodeやCodex、Cursorなどの「AIコーディングアシスタント」の性能を最大限に引き出すための総合チューニングシステムです。28種

AIコーディングの品質崩壊を解決!Claude Codeを「本当に使える開発マシン」に変えるシステム — get-shit-done

gsd-build/get-shit-doneJavaScript52.5k

Get Shit Done(GSD)は、Claude CodeなどのAIコーディングツールが長い会話を続けるうちに品質が劣化する「コンテキスト腐敗」問題を解決する開発支援システムです。アイデアを伝える

AI工学を基礎から学べるハーバード大学の教科書 — cs249r_book

harvard-edge/cs249r_bookJavaScript20.4k

AIシステム工学(AI工学)を基礎から学べるハーバード大学発の教科書です。AIモデルを作るだけでなく、実際に動く信頼性の高いAIシステムを設計・構築・評価する方法を教えています。無料でオンライン版が読

Claude/OpenAI/Geminiを統一管理!仲間とコスト分担できるAPI中継サービス — claude-relay-service

Wei-Shaw/claude-relay-serviceJavaScript8.7k

Claude Relay Serviceは、複数のAI APIサービス(Claude、OpenAI、Geminiなど)を一つのシステムで管理できるツールです。チームや友達と一緒にAIサブスクリプション

プログラマー魚皮が贈るAI完全攻略ガイド!Vibe Codingで誰でも開発者に — ai-guide

liyupi/ai-guideJavaScript8.0k

ai-guideは、プログラマーとして活動する魚皮さんが作成したAI学習リソースの総合プラットフォームです。大規模言語モデル(ChatGPTのようなAI)の選び方から、AI編程ツール(Cursorなど