使い方ガイドへスキップ
ios-design-review作者 Garry Tan

iOS Design Review スキル。

Claude Code と Codex のためのモバイルアプリデザインスキル:実機上での iOS アプリのビジュアルデザイン監査。

  • Mobile Apps
  • レビューレポート
garrytan/gstack · ios-design-review/SKILL.mdSKILL.md
--- name: ios-design-review description: Visual design audit for iOS apps on real hardware. (gstack) --- ## When to invoke this skill ## Confusion Protocol ## Claimed Limitations Need Evidence ## Continuous Checkpoint Mode ## Context Health (soft directive) ## Question Tuning (skip entirely if QUESTION_TUNING: false)
アップストリームファイルから読み込まれたフロントマターとセクション見出し(2026年9月14日)· 全33,841文字

01 できること

Claude CodeおよびCodexにおけるios-design-review Skillの機能

概要、ワークフロー、出力。いずれもスキルの SKILL.md から読み取った内容です。

SKILL.md より2026年9月14日読取 · 実行記録ではありません

スキル自身の言葉で

gstack-ios-qa-daemonを通じて実際のiPhoneに接続し、すべての画面をスクリーンショットで取得し、Apple HIG、DESIGN.md、ベストプラクティスに基づいて視覚的デザインを評価します。タイポグラフィの階層、スペーシングのリズム、カラーの階層、タッチターゲット、読み込み中・空・エラー状態、アクセシビリティ、アニメーションの節度、iOSイディオムとの整合性、情報密度、AI-slopチェックの10項目を0〜10点で採点し、「10点にするには何が必要か」という視点で評価します。

/plan-design-reviewの採点基準をiOSイディオムに移植したものです。スクリーンショット、画面ごとのスコア、最も効果の高い修正案を含むMarkdownレポートを生成します。実装前のプラン段階のデザインレビューには/plan-design-reviewを使用してください。実際に動作するWebの視覚的オーディットには/design-reviewを使用してください。

生成されるもの

  • スクリーンショットをインラインで含み、画面ごとのスコア(各項目0〜10点)と項目ごとの最も効果の高い修正案を記載したMarkdownレポート
プロンプト例を見る ↗

仕組み

  1. 01
    実行中のDaemonへ接続

    実行中のgstack-ios-qa-daemonを使用します。Daemonが起動していない場合は、/ios-qa(フェーズ0〜2)と同じフローで起動します。

  2. 02
    画面のキャプチャ

    主要な各画面(ユーザー指定の画面リストから、またはアクセシビリティツリーから自動検出)について、GET /screenshotおよびGET /elementsでスクリーンショットと要素を取得します。

  3. 03
    10項目の評価基準を適用

    タイポグラフィの階層、スペーシングのリズム、カラーの階層、タッチターゲット、読み込み中・空・エラー状態、アクセシビリティ、アニメーションの節度、iOSイディオムとの整合性、情報密度、AI-slopチェックを0〜10点で採点し、それぞれを10点にするには何が必要かを説明します。

  4. 04
    低スコアをフラグ表示

    7点未満のスコアについてはAskUserQuestionを使用し、問題点と推奨される修正案、トレードオフを提示することで、ユーザーが対応すべきかどうかを判断できるようにします。

  5. 05
    レポートの作成

    スクリーンショットをインラインで含み、画面ごとのスコアと項目ごとの最も効果の高い修正案を記載したMarkdownレポートを生成し、~/.gstack/projects/<slug>/ios-design-review-<date>.mdに書き出します。

02 適合性を確認

ios-design-review スキルを使用するとき

このようなモバイルアプリデザインの仕事には、Claude Code または Codex で ios-design-review スキルを使用してください。適合範囲と制限は、スキル自身のファイルから取得されています。

適している場合

  • 出荷前に実機でiOSアプリのビジュアルQAを行う
  • アクセシビリティ準拠のチェック(VoiceOverラベル、Dynamic Type、Reduce Motion)

境界を知る

  • 実装前の計画段階でのデザインレビュー(/plan-design-reviewを使用)
  • Webのライブビジュアル監査(/design-reviewを使用)

03 スキルの内部

ios-design-review スキルが Claude Code と Codex に与えるルール

SKILL.md がエージェントに設定する 8 つの具体的な指示・既定値・制限 — 結果を変える部分です。

  1. デフォルトで読み取り専用

    observe機能付きのセッションを取得し、iOSデバイスへの変更操作は一切行いません。

  2. タイポグラフィはSF ProとDynamic Typeを使用

    タイポグラフィ階層は、Apple HIGに準拠したSF Proの正しいdynamic-typeスケールで、displayとbodyとcaptionのサイズの一貫性を評価します。12pt以下のbodyテキストは一切許容されません。

  3. スペーシングは4ptまたは8ptグリッドに従う必要があります

    スペーシングのリズムの次元では、4ptまたは8ptグリッドを一貫して使用することが求められ、17/23/31ptのような場当たり的なパディングは許容されず、セーフエリアインセットが尊重されている必要があります。

  4. タップ対象は最小44x44pt

    すべてのインタラクティブ要素は最低44x44ptである必要があります。24pt未満のタップ可能なテキストは許容されません。

  5. コントラスト比はWCAG AAを満たす必要があります

    カラー階層の次元では、本文テキスト(4.5:1)と大きいテキスト(3:1)についてWCAG AAを満たすコントラスト比が求められ、ダークモードが正しく表示されている必要があります。

  6. アニメーションは同時2つまでに制限

    アニメーションの規律の次元では、同時アニメーションを2つまでに制限し、UIフィードバックの持続時間は200〜300msとし、正しいスプリングダンピング(重要なフローで弾みすぎないこと)を求めます。

  7. ネイティブiOSコンポーネントを使用

    iOSイディオムとの整合性の次元では、適切な場面でネイティブコンポーネント(NavigationStack、List、Form、システムシート)を使用することが求められ、独自に再発明されたナビゲーションや、電話上でのWebスタイルのハンバーガーメニューは許容されません。

  8. AIスロップパターンを検出

    AIスロップチェックの次元では、汎用的なストックレイアウト、残されたlorem ipsumデータ、Androidからそのまま輸入されたカーゴカルト的なMaterial Design、AI生成のグラデーションを検出します。

04 実際に使う

Claude Code または Codex に ios-design-review をインストールする

npx skills add コマンドを実行し、エージェントで最初のタスクを実行して、結果をチェックリストで確認します。

Claude Code、Codex、またはお使いのエージェントに ios-design-review を追加する

プロジェクトで実行してください。インストーラーが、どのエージェントに追加するかを尋ねます。

Terminal
npx skills add https://github.com/garrytan/gstack --skill ios-design-review

ios-design-review/SKILL.md用の汎用skills CLIコマンド。リポジトリが独自のパスを記載している場合があります。

スキルに最初のモバイルアプリデザインタスクを与える

スキル自身の用語で記述されています。角括弧の部分はご自身の内容に置き換えてください。

Starter prompt
Review the iOS design of [MyApp] running on the connected iPhone. Focus on the onboarding flow, home screen, and settings. Check for typography hierarchy issues, spacing rhythm inconsistencies, and accessibility compliance. Write the report to the project folder.

出典:SKILL.md をスキル自身の用語に沿って記述。

最初の結果を確認

SKILL.md 自体が正しい結果として示しているもの:

  • セッションがobserve機能で取得され、変更操作が一切行われていないことを確認してください

OpenDesignでios-design-reviewをSKILL.mdリンクからインポートします:Plugins → Add → Skill → Import from link、その後上部バーで選択します。

05 オープンソースで追跡可能

ソース、ライセンス、検証

このページの情報の出所と、最終確認日時です。

Author
Garry Tan
Repository
github.com/garrytan/gstack ブランチ main
スキルファイル
ios-design-review/SKILL.md 検証時に記録されたコンテンツチェックサム。コミット 71f6048
License
MIT LICENSE より。
リポジトリスター数
132,921 GitHub スナップショットは 2026-09-14 に取得されたもので、garrytan/gstack リポジトリ全体が対象です。このリポジトリにはカタログ内に 7 つのスキルが含まれています。ios-design-review の評価または使用数ではありません。
OpenDesign により検証済み
2026-09-14 ソースファイル、パス、ライセンステキスト、スター数を確認済み。OpenDesign 本体にはバンドルされていません(2026-08-28 確認)。このページには実行記録がありません。

SKILL.md の中身

  1. このスキルを呼び出すタイミングStateServer経由で実機上のiOSアプリのビジュアル監査を行い、10の次元を0〜10で評価します
  2. 接続実行中の gstack-ios-qa-daemon を使用し、必要な場合は /ios-qa フローで起動します。デフォルトでは読み取り専用です
  3. 評価軸とスコアリング10項目のルーブリック:タイポグラフィ、スペーシング、カラー、タッチターゲット、状態、アクセシビリティ、アニメーション、iOSのイディオム、密度、AI-slop
  4. ループセッションを取得し、各画面のスクリーンショットを撮影し、ルーブリックを適用して所見を記録し、Markdownレポートを作成します
  5. 出力スクリーンショットを本文中に含むMarkdownレポート。画面ごとのスコアと、最も効果の大きい改善提案を含みます
  6. 失敗モード403 capability_insufficient、空白のスクリーンショット、画面の欠落を処理します
スキル自身による説明
「実機での iOS アプリのビジュアルデザイン監査。(gstack)」

SKILL.md のフロントマター説明文です。完全なファイルは約 33,841 文字です。GitHub で完全なファイルを読む

06 インストールする前に

ios-design-review スキルに関するよくある質問

回答は 2026-09-14 時点で読んだ SKILL.md に基づくもので、記録された実行結果によるものではありません。

これと /plan-design-review の違いは何ですか?

このスキルは実機のiOSデバイス上で動作し、公開済みまたは開発中のアプリをApple HIGおよびiOSのイディオムに照らして評価します。/plan-design-review は実装前の設計仕様を評価するものです。このスキルは同じ採点ルーブリックをiOS向けに移植したものです。

iOS Design Review

実際のモバイルアプリデザインタスクで ios-design-review を実行する

OpenDesign をダウンロードし、SKILL.md リンクから ios-design-review をインポートし、上記のプロンプトを貼り付けて、結果の前に計画を確認してください。

ターミナル
npx skills add https://github.com/garrytan/gstack --skill ios-design-review

OpenDesign デスクトップ版

ひとつのデザインシステムで、すべての制作物をブランドらしく

完全な Vibe Design Workspace で、同じブランドルールを Web サイト、スライド、操作できるプロトタイプ、ダッシュボード、画像、HTML 動画に展開できます。ローカルの Codex、Claude Code、Cursor などを接続して無料で制作しましょう。

  • Web、スライド、プロトタイプ、ダッシュボード、画像、動画
  • 140+ のデザインシステムと完全なテンプレート/スキルライブラリ
  • ローカル Codex と 21+ のコーディングエージェントを接続 · 無料
無料ダウンロード

macOS と Windows に対応