返回技能列表

review-web-design

pjt222
更新于 2 days ago
7 次查看
17
2
17
在 GitHub 上查看
设计design

关于

This Claude Skill reviews web designs by evaluating layout, typography, color, spacing, responsiveness, and brand consistency. It provides actionable feedback on design principles and improvement recommendations. Use it to assess mockups, live sites, or during design reviews before development.

快速安装

Claude Code

推荐
主要方式
npx skills add pjt222/agent-almanac -a claude-code
插件命令备选方式
/plugin add https://github.com/pjt222/agent-almanac
Git 克隆备选方式
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/review-web-design

在 Claude Code 中复制并粘贴此命令以安装该技能

技能文档

Review Web Design

Judge web design for visual quality, consistency, effectiveness across devices.

When Use

  • Review mockup or prototype before dev
  • Judge implemented site for design quality
  • Give feedback in design review
  • Check brand consistency across pages
  • Test responsive behaviour at breakpoints

Inputs

  • Required: Design (URL, mockup, screenshots, source)
  • Optional: Brand guidelines or design system docs
  • Optional: Target audience description
  • Optional: Reference designs or competitors
  • Optional: Areas of concern

Steps

Step 1: Assess Visual Hierarchy

Hierarchy guides eye through content by importance.

  • Focal point: Obvious entry point per page?
  • Heading hierarchy: H1 → H2 → H3 logical?
  • Size contrast: Important elements bigger?
  • Colour contrast: CTAs prominent?
  • Whitespace: Spacing separates groups?
  • Reading flow: F-pattern, Z-pattern?
## 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 |

Got: Each page assessed for hierarchy.

If fail: No mockups? Assess from live code via dev tools.

Step 2: Evaluate Typography

  • Font selection: Right for brand, content?
  • Font pairing: Heading + body fit (max 2-3 families)?
  • Type scale: Consistent (1.25 major second, 1.333 perfect fourth)?
  • Line height: Body 1.4-1.6; headings 1.1-1.3
  • Line length: Body 45-75 chars (~66 best)
  • Font weight: Used consistent for hierarchy
  • Font size: Base ≥ 16px for body
/* 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 */
}

Got: Typography assessed for consistency, readability, hierarchy.

If fail: More than 3 font families? Recommend consolidation.

Step 3: Review Colour Usage

  • Palette coherence: Intentional, limited (3-5 + neutrals)?
  • Brand alignment: Match guidelines?
  • Contrast ratios: WCAG AA (4.5:1 normal, 3:1 large)
  • Semantic colour: Consistent meaning (red=err, green=ok)?
  • Colour blindness: Info conveyed by more than colour?
  • Dark/light mode: Both modes readable, on-brand?
## 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 |

Got: Palette reviewed for coherence, accessibility, semantic consistency.

If fail: Use contrast checker (WebAIM) for exact ratios.

Step 4: Assess Layout and Spacing

  • Grid system: Consistent grid (12-col, auto, custom)?
  • Spacing scale: Systematic (4px/8px base, Tailwind-like)?
  • Alignment: Elements on grid (no "almost aligned")?
  • Density: Right for content (data-heavy vs marketing)?
  • Whitespace: Used to group, separate?
  • Consistency: Similar sections spaced same?

Spacing audit.

## 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 |

Got: Layout uses systematic grid, spacing scale.

If fail: Spacing inconsistent? Recommend spacing scale (Tailwind space-*).

Step 5: Evaluate Responsive Design

Test at key breakpoints.

BreakpointWidthRepresents
Mobile375pxiPhone SE / small phones
Mobile L428pxiPhone 14 / large phones
Tablet768pxiPad portrait
Desktop1280pxStandard laptop
Wide1536px+Desktop monitor

Per breakpoint check.

  • Layout adaptation: Reflow right (stack mobile, side-by-side desktop)?
  • Touch targets: ≥ 44x44px on mobile?
  • Text readability: Font size right for viewport?
  • Image scaling: Resize without distortion or overflow?
  • Navigation: Mobile nav accessible (hamburger, bottom)?
  • No horizontal scroll: Content does not overflow horizontal
## 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 |

Got: Design tested at all key breakpoints, issues documented.

If fail: No responsive tools? Review CSS media queries for coverage.

Step 6: Check Brand Consistency

  • Logo usage: Right size, spacing, clear zone
  • Colour accuracy: Brand colors match spec (hex values, not "close")
  • Typography match: Fonts match brand
  • Tone/voice: UI copy matches brand personality
  • Iconography: Consistent set (style, weight, grid)
  • Photography style: Match brand if applicable

Got: Brand elements verified vs guidelines, deviations noted.

If fail: No brand guidelines? Note as recommendation, assess internal consistency.

Step 7: Write Design Review

## 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]

Got: Review gives specific, visual-reference feedback with prioritized improvements.

If fail: Scoring feels arbitrary? Use simpler pass/concern/fail.

Checks

  • Visual hierarchy assessed for all major pages
  • Typography evaluated for readability, consistency, scale
  • Colour contrast verified vs WCAG AA min
  • Layout and spacing checked for grid consistency
  • Responsive design tested at 3+ breakpoints
  • Brand consistency verified vs guidelines (or internal consistency)
  • Feedback specific with visual refs (page, section, element)

Pitfalls

  • Subjective without reasoning: "I don't like the colour" not actionable. Explain why (contrast, brand mismatch, accessibility).
  • Ignore accessibility: Visual review must include WCAG contrast. Beautiful designs that exclude users not good.
  • Review mockups only: Test responsive, hover states, transitions — not just static layouts.
  • Prescribe solutions: Describe problem ("text hard to read") not dictate fix ("use #333").
  • Forget context: Banking app and gaming site have different standards. Review against right context.

See Also

  • review-ux-ui — usability, interaction, accessibility
  • setup-tailwind-typescript — Tailwind CSS for design systems
  • scaffold-nextjs-app — Next.js scaffolding

GitHub 仓库

pjt222/agent-almanac
路径: i18n/caveman/skills/review-web-design
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

相关推荐技能

executing-plans

设计

该Skill用于当开发者提供完整实施计划时,以受控批次方式执行代码实现。它会先审阅计划并提出疑问,然后分批次执行任务(默认每批3个任务),并在批次间暂停等待审查。关键特性包括分批次执行、内置检查点和架构师审查机制,确保复杂系统实现的可控性。

查看技能

requesting-code-review

设计

该Skill可在完成任务、实现主要功能或合并代码前自动调度代码审查子代理,确保实现符合需求和计划。它支持通过指定git SHA范围进行精准的代码变更审查,帮助开发者在关键节点及时发现潜在问题。核心原则是"早审查、勤审查",适用于开发流程的各个关键阶段。

查看技能

connect-mcp-server

设计

这个Skill指导开发者如何将MCP服务器连接到Claude Code,支持HTTP、stdio和SSE三种传输协议。它涵盖了从安装配置到认证安全的完整流程,适用于集成GitHub、Notion、数据库等外部服务。当开发者需要添加集成、配置外部工具或提及MCP相关功能时,这个Skill能提供实用的操作指南。

查看技能

web-cli-teleport

设计

该Skill帮助开发者根据任务特性选择Claude Code的Web或CLI界面,并指导如何在两种环境间无缝迁移会话。它能分析任务复杂度、迭代需求等要素,推荐最优工作界面和工作流。关键特性包括会话状态管理、环境切换指导和上下文优化建议。

查看技能