From agent-almanac
Reviews web designs for layout quality, typography, color usage, spacing, responsive behavior, brand consistency, and visual hierarchy. Use for mockup reviews before development, implemented site assessments, design feedback, or breakpoint checks.
npx claudepluginhub pjt222/agent-almanacThis skill uses the workspace's default tool permissions.
---
Reviews web app or page visual design for layout, typography, spacing, color, hierarchy, consistency, interactions, and responsiveness. Outputs polished findings report with screenshots.
Evaluates UI visual design and aesthetics via screenshots, analyzing typography, color palettes, spacing, hierarchy, consistency, branding, and modern trends for professional polish.
Audits visual design quality for red flags in typography, color, layout; classifies severity and suggests fixes. Use for design QA, visual reviews, or bug checks.
Share bugs, ideas, or general feedback.
Evaluate a web design for visual quality, consistency, and effectiveness across devices.
Visual hierarchy guides the user's eye through content in order of importance.
## 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 |
Expected: Each major page/section assessed for clear visual hierarchy. On failure: If mockups are unavailable, assess from live code using browser dev tools.
/* 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 */
}
Expected: Typography assessed for consistency, readability, and hierarchy. On failure: If the design uses more than 3 font families, recommend consolidation.
## 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 |
Expected: Colour palette reviewed for coherence, accessibility, and semantic consistency. On failure: Use a contrast checker tool (WebAIM) to verify exact ratios.
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 |
Expected: Layout uses a systematic grid and spacing scale consistently.
On failure: If spacing is inconsistent, recommend adopting a spacing scale (e.g., Tailwind's space-*).
Test across key breakpoints:
| Breakpoint | Width | Represents |
|---|---|---|
| Mobile | 375px | iPhone SE / small phones |
| Mobile L | 428px | iPhone 14 / large phones |
| Tablet | 768px | iPad portrait |
| Desktop | 1280px | Standard laptop |
| Wide | 1536px+ | Desktop monitor |
Check at each breakpoint:
## 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 |
Expected: Design tested at all key breakpoints with issues documented. On failure: If responsive testing tools are unavailable, review CSS media queries for coverage.
Expected: Brand elements verified against guidelines with specific deviations noted. On failure: If brand guidelines don't exist, note this as a recommendation and assess internal consistency instead.
## 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]
Expected: Review provides specific, visual-reference feedback with prioritized improvements. On failure: If scoring feels arbitrary, use a simpler pass/concern/fail system instead.
review-ux-ui — usability, interaction patterns, and accessibility (complementary to visual design)setup-tailwind-typescript — Tailwind CSS implementation for design systemsscaffold-nextjs-app — Next.js application scaffolding