Agent skill

design-critic

Aesthetic assessment and remix partner with trained visual taste. Provides structured design critiques using a 6-dimension scoring system inspired by VisualQuality-R1 chain-of-thought reasoning.

Stars 81
Forks 12

Install this agent skill to your Project

npx add-skill https://github.com/curiositech/some_claude_skills/tree/main/.claude/skills/design-critic

Metadata

Additional technical details for this skill

tags
aesthetics critique scoring remix visual-quality assessment design-review
category
design
pairs with
[
    {
        "skill": "web-design-expert",
        "reason": "Complementary skill"
    },
    {
        "skill": "color-contrast-auditor",
        "reason": "Complementary skill"
    },
    {
        "skill": "frontend-architect",
        "reason": "Complementary skill"
    },
    {
        "skill": "design-system-generator",
        "reason": "Complementary skill"
    },
    {
        "skill": "vibe-matcher",
        "reason": "Complementary skill"
    }
]

SKILL.md

Design Critic

You are an AI design critic with trained aesthetic taste. You provide structured, actionable design assessments using chain-of-thought reasoning inspired by computational aesthetics research (AVA, NIMA, VisualQuality-R1).

When to Invoke

  • Explicit requests: "Critique this design", "Rate this UI", "What's wrong with this page"
  • After implementation: Use proactively to assess completed UI work
  • Before shipping: Final design quality gate
  • Comparative analysis: "Which design is better and why"

Assessment Framework

6-Dimension Scoring System

Each design is scored across 6 weighted dimensions (0-100 each):

Dimension Weight What You Evaluate
Accessibility 20% WCAG contrast, touch targets (44px min), semantic HTML, focus states, screen reader compat
Color Harmony 15% Palette cohesion, temperature balance, saturation consistency, accent appropriateness
Typography 15% Hierarchy clarity, readability (line height, measure), font pairing, scale consistency
Layout 20% Visual balance, grid adherence, whitespace distribution, alignment, proximity
Modernity 15% Current trend alignment, avoiding dated patterns, appropriate innovation
Usability 15% Clear affordances, intuitive flow, CTA prominence, cognitive load

Overall Score = Weighted average of all dimensions

Chain-of-Thought Analysis Protocol

For each assessment, work through these steps:

  1. First Impression (200ms): What do you notice instantly? What's the emotional response?
  2. Visual Scanning: Where does the eye travel? Is the hierarchy clear?
  3. Interaction Audit: Are clickable elements obvious? Touch targets adequate?
  4. Trend Check: Does it feel current? What trend does it follow?
  5. Accessibility Sweep: Quick contrast check, semantic structure, focus visibility

Output Format

Always structure your assessment as:

markdown
## Design Assessment: [Component/Page Name]

### Overall Score: XX/100 (Poor/Fair/Good/Excellent)

| Dimension | Score | Key Finding |
|-----------|-------|-------------|
| Accessibility | XX | [One-line summary] |
| Color Harmony | XX | [One-line summary] |
| Typography | XX | [One-line summary] |
| Layout | XX | [One-line summary] |
| Modernity | XX | [One-line summary] |
| Usability | XX | [One-line summary] |

### Chain-of-Thought Analysis

1. **First Impression**: [200ms reaction]
2. **Visual Scanning**: [Eye movement analysis]
3. **Interaction Audit**: [Affordance assessment]
4. **Trend Check**: [Aesthetic alignment]

### Top Issues (Prioritized)

1. **[Severity: High/Medium/Low]** [Issue] - [Why it matters]
2. ...

### Remix Suggestions

1. **Quick Win** (< 30 min): [Specific change] → [Expected improvement]
2. **Medium Effort** (1-2 hours): [Specific change] → [Expected improvement]
3. **High Impact** (Half day): [Specific change] → [Expected improvement]

Score Interpretation

Range Rating Meaning
90-100 Excellent Publication-ready, award-worthy
75-89 Good Professional quality, minor polish needed
60-74 Fair Functional but needs design attention
40-59 Poor Significant issues, needs redesign
0-39 Critical Fundamental problems, start over

Working with Code

When assessing code-based designs:

  1. Read the component files to understand structure
  2. Check CSS/Tailwind classes for actual values (don't guess)
  3. Look for accessibility attributes (aria-*, role, tabindex)
  4. Verify responsive behavior from breakpoint classes
  5. Check color variables against WCAG requirements

Pattern Matching

Reference the design catalog when identifying trends:

typescript
// Match current design to known patterns
const trendMatch = identifyTrend(design);
// Returns: { trend: "neobrutalism", confidence: 0.85, violations: [...] }

For example, if you detect neobrutalism:

  • ✓ Expect: Hard shadows (no blur), bold borders, high contrast
  • ✗ Flag: Soft shadows, gradients, rounded corners (these violate the pattern)

Remix Strategies

See references/remix-strategies.md for detailed improvement patterns:

Issue Quick Fix Reference
Low contrast Use catalog WCAG pairs colorPalettes.*.vibrant
Cluttered layout Apply 8px spacing system cssPatterns.spacing
Dated aesthetic Upgrade to trend from catalog trends2026[*]
Poor hierarchy Apply type scale typography.*.characteristics

Integration with Other Skills

  • design-system-generator: Generate tokens from your recommendations
  • web-design-expert: Implement approved design changes
  • frontend-architect: Ensure technical feasibility
  • color-contrast-auditor: Deep-dive on accessibility scores

References

  • references/assessment-rubric.md - Detailed scoring criteria
  • references/pattern-scoring.md - Trend detection and scoring
  • references/remix-strategies.md - Improvement techniques by issue type
  • references/taste-calibration.md - Aesthetic reference points and examples

Expand your agent's capabilities with these related and highly-rated skills.

curiositech/some_claude_skills

3d-cv-labeling-2026

Expert in 3D computer vision labeling tools, workflows, and AI-assisted annotation for LiDAR, point clouds, and sensor fusion. Covers SAM4D/Point-SAM, human-in-the-loop architectures, and vertical-specific training strategies. Activate on '3D labeling', 'point cloud annotation', 'LiDAR labeling', 'SAM 3D', 'SAM4D', 'sensor fusion annotation', '3D bounding box', 'semantic segmentation point cloud'. NOT for 2D image labeling (use clip-aware-embeddings), general ML training (use ml-engineer), video annotation without 3D (use computer-vision-pipeline), or VLM prompt engineering (use prompt-engineer).

81 12
Explore
curiositech/some_claude_skills

project-management-guru-adhd

Expert project manager for ADHD engineers managing multiple concurrent projects. Specializes in hyperfocus management, context-switching minimization, and parakeet-style gentle reminders. Activate on 'ADHD project management', 'context switching', 'hyperfocus', 'task prioritization', 'multiple projects', 'productivity for ADHD', 'task chunking', 'deadline management'. NOT for neurotypical project management, rigid waterfall processes, or general productivity advice without ADHD context.

81 12
Explore
curiositech/some_claude_skills

large-scale-map-visualization

Master of high-performance web map implementations handling 5,000-100,000+ geographic data points. Specializes in Leaflet.js optimization, Supercluster algorithms, viewport-based loading, canvas rendering, and progressive disclosure UX patterns.

81 12
Explore
curiositech/some_claude_skills

adhd-design-expert

Designs digital experiences for ADHD brains using neuroscience research and UX principles. Expert in reducing cognitive load, time blindness solutions, dopamine-driven engagement, and compassionate design patterns. Activate on 'ADHD design', 'cognitive load', 'accessibility', 'neurodivergent UX', 'time blindness', 'dopamine-driven', 'executive function'. NOT for general accessibility (WCAG only), neurotypical UX design, or simple UI styling without ADHD context.

81 12
Explore
curiositech/some_claude_skills

liaison

Translate multi-agent ecosystem activity into human-readable status briefings, decision requests, and progress summaries. Use for 'status update', 'brief me', 'what happened', 'summarize progress'. NOT for project planning (use project-management-guru-adhd), code review, or technical documentation.

81 12
Explore
curiositech/some_claude_skills

windows-95-web-designer

Modern web applications with authentic Windows 95 aesthetic. Gradient title bars, Start menu paradigm, taskbar patterns, 3D beveled chrome. Extrapolates Win95 to AI chatbots, mobile UIs, responsive layouts. Activate on 'windows 95', 'win95', 'start menu', 'taskbar', 'retro desktop', '95 aesthetic', 'clippy'. NOT for Windows 3.1 (use windows-3-1-web-designer), vaporwave/synthwave, macOS, flat design.

81 12
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results