Back to Skills

review-web-design

pjt222
Updated 2 days ago
6 views
17
2
17
View on GitHub
Designdesign

About

This skill reviews web designs across layout, typography, color, spacing, responsiveness, and brand consistency. It provides evaluations and improvement recommendations for mockups, implemented sites, or during review sessions. Developers can use it to assess visual quality and ensure responsive behavior before or after implementation.

Quick Install

Claude Code

Recommended
Primary
npx skills add pjt222/agent-almanac -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternative
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/review-web-design

Copy and paste this command in Claude Code to install this skill

Documentation


name: review-web-design description: > Webデザインをレイアウト品質、タイポグラフィ、カラー使用、スペーシング、 レスポンシブな動作、ブランド一貫性、ビジュアル階層の観点でレビューする。 デザイン原則の評価と改善推奨事項を網羅する。開発前のデザインモックアップレビュー、 実装済みサイトのデザイン品質評価、デザインレビューセッションでのフィードバック提供、 ブランド一貫性の評価、またはブレークポイントをまたいだレスポンシブ動作の確認に使用する。 locale: ja source_locale: en source_commit: 6f65f316 translator: claude-opus-4-6 translation_date: 2026-03-16 license: MIT allowed-tools: Read Grep Glob WebFetch metadata: author: Philipp Thoss version: "1.0" domain: review complexity: intermediate language: multi tags: web-design, layout, typography, colour, responsive, visual-hierarchy, branding

Review Web Design

Webデザインを視覚的品質、一貫性、デバイスをまたいだ効果性について評価する。

使用タイミング

  • 開発前にデザインモックアップやプロトタイプをレビューする場合
  • 実装済みウェブサイトまたはウェブアプリケーションのデザイン品質を評価する場合
  • デザインレビューセッションでビジュアルデザインにフィードバックを提供する場合
  • 複数のページやセクションにわたるブランド一貫性を評価する場合
  • ブレークポイントをまたいだレスポンシブデザインの動作を確認する場合

入力

  • 必須: レビュー対象のデザイン(URL、モックアップファイル、スクリーンショット、またはソースコード)
  • 任意: ブランドガイドラインまたはデザインシステムドキュメント
  • 任意: ターゲットオーディエンスの説明
  • 任意: 参照デザインまたは競合他社の例
  • 任意: 特定の懸念領域

手順

ステップ1: ビジュアル階層の評価

ビジュアル階層はユーザーの目を重要度の順にコンテンツへと導く。

  • 明確な焦点: 各ページ/画面に明らかなエントリーポイントがあるか?
  • 見出し階層: 見出しが論理的に降順になっているか(H1 → H2 → H3)?
  • サイズのコントラスト: 重要な要素がサポート要素より大きいか?
  • カラーのコントラスト: CTAと主要なアクションが視覚的に目立つか?
  • ホワイトスペース: スペーシングが論理的なグループを効果的に分離しているか?
  • 読み取りフロー: レイアウトが自然な読み取りパターンに従っているか(F字型、Z字型)?
## Visual Hierarchy Assessment
| Page/Section | Focal Point | Hierarchy Clear? | Issues |
|-------------|-------------|-----------------|--------|
| Homepage | Hero section CTA | Yes | Secondary CTA competes with primary |
| Product page | Product image | Mostly | Price not prominent enough |
| Contact form | Submit button | No | Form title same size as body text |

期待結果: 主要な各ページ/セクションの明確なビジュアル階層が評価されている。 失敗時: モックアップが利用できない場合は、ブラウザの開発者ツールを使用してライブコードから評価する。

ステップ2: タイポグラフィの評価

  • フォント選択: フォントはブランドとコンテンツタイプに適切か?
  • フォントのペアリング: 見出しと本文フォントが補完し合っているか(最大2〜3ファミリー)?
  • タイプスケール: 一貫したスケールが使用されているか(例:1.25のメジャーセカンド、1.333のパーフェクトフォース)?
  • 行の高さ: 本文テキストの行の高さは1.4〜1.6、見出しは1.1〜1.3
  • 行の長さ: 本文テキストの行の長さは45〜75文字(最適は約66)
  • フォントウェイト: ウェイトの変化が階層を示すために一貫して使用されているか
  • フォントサイズ: 本文テキストのベースフォントサイズが少なくとも16pxか
/* Example well-structured type scale (1.25 ratio) */
:root {
  --text-xs: 0.64rem;    /* 10.24px */
  --text-sm: 0.8rem;     /* 12.8px */
  --text-base: 1rem;     /* 16px */
  --text-lg: 1.25rem;    /* 20px */
  --text-xl: 1.563rem;   /* 25px */
  --text-2xl: 1.953rem;  /* 31.25px */
  --text-3xl: 2.441rem;  /* 39.06px */
}

期待結果: タイポグラフィが一貫性、可読性、階層について評価されている。 失敗時: デザインが3つ以上のフォントファミリーを使用している場合は統合を推奨する。

ステップ3: カラー使用のレビュー

  • パレットの一貫性: カラーパレットが意図的で限定されているか(通常3〜5色+ニュートラル)?
  • ブランドの整合性: カラーはブランドガイドラインと一致しているか?
  • コントラスト比: テキストがWCAG AA(通常テキストは4.5:1、大きいテキストは3:1)を満たしているか
  • 意味的カラー: カラーが意味のために一貫して使用されているか(赤=エラー、緑=成功)?
  • 色覚異常: 情報がカラーだけで伝えられていないか?
  • ダーク/ライトモード: サポートされている場合、両方のモードが可読性とブランド一貫性を維持しているか
## Colour Assessment
| Usage | Colour | Contrast Ratio | WCAG AA | Notes |
|-------|--------|----------------|---------|-------|
| Body text on white | #333333 | 12.6:1 | Pass | Good |
| Link text on white | #2563eb | 5.2:1 | Pass | Good |
| Muted text on light gray | #9ca3af on #f3f4f6 | 2.1:1 | FAIL | Increase contrast |
| CTA button text | #ffffff on #22c55e | 3.1:1 | FAIL for small text | Use darker green or larger text |

期待結果: カラーパレットが一貫性、アクセシビリティ、意味的一貫性について評価されている。 失敗時: 正確な比率を確認するためにコントラストチェッカーツール(WebAIM)を使用する。

ステップ4: レイアウトとスペーシングの評価

  • グリッドシステム: 一貫したグリッドが使用されているか(12カラム、オートレイアウト、またはカスタム)?
  • スペーシングスケール: スペーシングが体系的か(4px/8pxベース、またはTailwindのようなスケール)?
  • 整列: 要素がグリッドに整列しているか(「ほぼ整列した」項目がないか)?
  • 密度: 情報密度がコンテンツタイプに適しているか(データ重視 vs. マーケティング)?
  • ホワイトスペース: ホワイトスペースがグループ化と分離のために意図的に使用されているか?
  • 一貫性: 類似したセクションが同じようにスペーシングされているか?

スペーシング監査:

## Spacing Consistency Check
| Element Pair | Expected Gap | Actual Gap | Consistent? |
|-------------|-------------|------------|-------------|
| Section title to content | 24px | 24px | Yes |
| Card to card | 16px | 16px/24px | No — inconsistent |
| Form label to input | 8px | 4px/8px/12px | No — varies |

期待結果: レイアウトが体系的なグリッドとスペーシングスケールを一貫して使用している。 失敗時: スペーシングが一貫していない場合は、スペーシングスケールの採用を推奨する(例:Tailwindの space-*)。

ステップ5: レスポンシブデザインの評価

主要なブレークポイントでテストする:

ブレークポイント対象
Mobile375pxiPhone SE / 小型スマートフォン
Mobile L428pxiPhone 14 / 大型スマートフォン
Tablet768pxiPad ポートレート
Desktop1280px標準的なノートパソコン
Wide1536px+デスクトップモニター

各ブレークポイントで確認:

  • レイアウトの適応: レイアウトが適切にリフローするか(モバイルでスタック、デスクトップで並列)?
  • タッチターゲット: インタラクティブ要素がモバイルで少なくとも44x44pxか?
  • テキストの可読性: ビューポートに適したフォントサイズか?
  • 画像のスケーリング: 歪みやオーバーフローなしに画像がリサイズされるか?
  • ナビゲーション: モバイルナビゲーションがアクセシブルか(ハンバーガー、ボトムナビなど)?
  • 水平スクロールなし: コンテンツがビューポートから水平にはみ出していない
## Responsive Review
| Breakpoint | Layout | Touch Targets | Text | Images | Navigation | Issues |
|-----------|--------|---------------|------|--------|------------|--------|
| 375px | OK | OK | OK | Overflow on hero | Hamburger | Hero image clips |
| 768px | OK | OK | OK | OK | Hamburger | None |
| 1280px | OK | N/A | OK | OK | Full nav | None |
| 1536px | OK | N/A | Line length too long | OK | Full nav | Add max-width to content |

期待結果: 主要なすべてのブレークポイントでデザインがテストされ、問題が文書化されている。 失敗時: レスポンシブテストツールが利用できない場合は、CSSメディアクエリのカバレッジをレビューする。

ステップ6: ブランド一貫性の確認

  • ロゴの使用: ロゴが正しくレンダリングされているか(サイズ、スペーシング、クリアゾーン)
  • カラーの正確性: ブランドカラーが仕様と一致しているか(16進値が「大体」ではなく正確か)
  • タイポグラフィの一致: フォントがブランドガイドラインと一致しているか
  • トーン/声: UIコピーがブランドパーソナリティと一致しているか
  • アイコングラフィ: アイコンが一貫したセットから使用されているか(スタイル、ウェイト、グリッド)
  • 写真スタイル: 画像がブランドガイドラインと一致しているか(該当する場合)

期待結果: ブランド要素がガイドラインに対して検証され、具体的な逸脱が記録されている。 失敗時: ブランドガイドラインが存在しない場合は、これを推奨事項として記録し、代わりに内部一貫性を評価する。

ステップ7: デザインレビューの執筆

## Web Design Review

### Overall Impression
[2-3 sentences: overall quality, strongest and weakest aspects]

### Visual Hierarchy: [Score/5]
[Key findings with specific references]

### Typography: [Score/5]
[Key findings with specific references]

### Colour: [Score/5]
[Key findings with specific references]

### Layout & Spacing: [Score/5]
[Key findings with specific references]

### Responsive Design: [Score/5]
[Key findings with specific references]

### Brand Consistency: [Score/5]
[Key findings with specific references]

### Priority Improvements
1. [Most impactful change — specific and actionable]
2. [Second priority]
3. [Third priority]

### Positive Notes
1. [What works well and should be preserved]

期待結果: レビューが優先順位付けされた改善事項を含む具体的なビジュアル参照フィードバックを提供している。 失敗時: スコアリングが恣意的に感じられる場合は、代わりにより単純なpass/concern/failシステムを使用する。

バリデーション

  • すべての主要なページ/セクションのビジュアル階層が評価されている
  • タイポグラフィが可読性、一貫性、スケールについて評価されている
  • カラーコントラストがWCAG AAの最低基準に対して検証されている
  • レイアウトとスペーシングがグリッド一貫性について確認されている
  • レスポンシブデザインが3つ以上のブレークポイントでテストされている
  • ブランド一貫性がガイドラインに対して検証されている(またはない場合は内部一貫性が評価されている)
  • フィードバックがビジュアル参照(ページ、セクション、要素)を含む具体的なものである

よくある落とし穴

  • 根拠なしの主観: 「このカラーが好きじゃない」は実行可能でない。なぜか(コントラスト、ブランドの不一致、アクセシビリティ)を説明すること。
  • アクセシビリティを無視する: ビジュアルデザインレビューにはWCAGコントラストチェックが含まれなければならない。ユーザーを排除する美しいデザインは良いデザインではない。
  • モックアップのみをレビューする: レスポンシブ動作、ホバー状態、トランジションをテストすること — 静的レイアウトだけではなく。
  • 解決策を規定する: 特定の修正を指示するのではなく(「#333を使用せよ」)、問題を説明すること(「このテキストはこの背景では読みにくい」)。
  • コンテキストを忘れる: 銀行アプリとゲームサイトは異なるデザイン標準を持つ。適切なコンテキストに対してレビューすること。

関連スキル

  • review-ux-ui — ユーザビリティ、インタラクションパターン、アクセシビリティ(ビジュアルデザインを補完)
  • setup-tailwind-typescript — デザインシステムのためのTailwind CSSの実装
  • scaffold-nextjs-app — Next.jsアプリケーションのスキャフォールディング

GitHub Repository

pjt222/agent-almanac
Path: i18n/ja/skills/review-web-design
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Related Skills

executing-plans

Design

Use the executing-plans skill when you have a complete implementation plan to execute in controlled batches with review checkpoints. It loads and critically reviews the plan, then executes tasks in small batches (default 3 tasks) while reporting progress between each batch for architect review. This ensures systematic implementation with built-in quality control checkpoints.

View skill

requesting-code-review

Design

This skill dispatches a code-reviewer subagent to analyze code changes against requirements before proceeding. It should be used after completing tasks, implementing major features, or before merging to main. The review helps catch issues early by comparing the current implementation with the original plan.

View skill

connect-mcp-server

Design

This skill provides a comprehensive guide for developers to connect MCP servers to Claude Code using HTTP, stdio, or SSE transports. It covers installation, configuration, authentication, and security for integrating external services like GitHub, Notion, and custom APIs. Use it when setting up MCP integrations, configuring external tools, or working with Claude's Model Context Protocol.

View skill

web-cli-teleport

Design

This skill helps developers choose between Claude Code Web and CLI interfaces based on task analysis, then enables seamless session teleportation between these environments. It optimizes workflow by managing session state and context when switching between web, CLI, or mobile. Use it for complex projects requiring different tools at various stages.

View skill