Agent skill
design-evaluation-audit
Use when systematically evaluating existing designs for cognitive alignment, conducting design reviews or critiques, diagnosing usability issues, quality assurance before launch, or choosing between design alternatives with objective criteria. Invoke when user mentions design review, design critique, evaluate design, audit visualization, checklist, cognitive assessment, or usability evaluation.
Install this agent skill to your Project
npx add-skill https://github.com/lyndonkl/claude/tree/main/skills/design-evaluation-audit
SKILL.md
Design Evaluation & Audit
Table of Contents
- Read This First
- Design Review Workflow
- Path Selection Menu
- Path 1: Run Cognitive Design Checklist
- Path 2: Run Visualization Audit
- Path 3: Combined Review
- Quick Reference
- Guardrails
Read This First
What This Skill Does
This skill provides systematic evaluation tools for assessing existing designs against cognitive science principles. It gives you repeatable checklists, scoring rubrics, and prioritized fix recommendations.
Core principle: Good evaluation is systematic, not subjective — every dimension gets checked, every finding gets severity-classified, every fix gets prioritized.
Why It Matters
Common problems this addresses:
- Design reviews that miss critical issues because they rely on gut feeling
- Teams disagreeing on what to fix first without objective framework
- Usability problems shipping because no one checked systematically
- Visualizations that mislead because integrity was never audited
How this helps:
- Covers all cognitive dimensions (visibility, hierarchy, chunking, memory, feedback, consistency, scanning, simplicity)
- Scores visualizations on 4 independent criteria (Clarity, Efficiency, Integrity, Aesthetics)
- Classifies findings by severity (CRITICAL/HIGH/MEDIUM/LOW)
- Produces actionable fix recommendations with clear priority order
When to Use This Skill
Use this skill when:
- ✓ Conducting design reviews or critiques
- ✓ Evaluating designs for cognitive alignment before iteration
- ✓ Quality assurance before launch or publication
- ✓ Diagnosing why a design "feels off"
- ✓ Choosing between design alternatives with objective criteria
- ✓ Auditing data visualizations for quality
Do NOT use for:
- ✗ Creating new designs from scratch (use
cognitive-design) - ✗ Learning cognitive theory (use
cognitive-designPath 1) - ✗ Detecting misleading visualizations (use
cognitive-fallacies-guard) - ✗ Technical implementation (coding, tooling)
Design Review Workflow
Time: 30-90 minutes depending on scope
Copy this checklist and track your progress:
Design Evaluation Progress:
- [ ] Step 1: Systematic Assessment
- [ ] Step 2: Visualization Quality Audit (if applicable)
- [ ] Step 3: Severity Classification & Prioritization
- [ ] Step 4: Fix Recommendations
Step 1: Systematic Assessment
Apply the Cognitive Design Checklist across all 8 dimensions: Visibility, Visual Hierarchy, Chunking, Simplicity, Memory Support, Feedback, Consistency, Scanning Patterns. Check every item. Record pass/fail for each dimension with specific evidence.
Resource: Cognitive Design Checklist
Step 2: Visualization Quality Audit (if applicable)
If the design includes data visualizations, apply the 4-Criteria Visualization Audit. Score each criterion 1-5: Clarity, Efficiency, Integrity, Aesthetics. Calculate average and identify weakest dimension.
Resource: Visualization Audit Framework
Step 3: Severity Classification & Prioritization
Classify every finding by severity:
- CRITICAL: Integrity violations, accessibility failures, users cannot complete core tasks. Fix immediately.
- HIGH: Clarity/efficiency issues preventing use, missing feedback for critical actions, working memory overload (>10 ungrouped items). Fix before launch.
- MEDIUM: Suboptimal patterns, aesthetic issues, minor inconsistencies. Fix in next iteration.
- LOW: Minor optimizations, polish items. Fix when convenient.
Priority rule: Fix foundation-first — perception before coherence, integrity before aesthetics, critical before high.
Step 4: Fix Recommendations
For each finding, document:
- What is wrong — specific description with evidence
- Why it matters — which cognitive principle is violated
- How to fix — concrete, actionable recommendation
- Expected outcome — what improves after the fix
- Effort estimate — quick fix (minutes), moderate (hours), significant (days)
Verify fixes don't harm other dimensions.
Path Selection Menu
Path 1: Run Cognitive Design Checklist
Choose this when: Evaluating any interface, layout, content page, form, or general design.
What you'll get: Pass/fail across 8 cognitive dimensions, test methods, common failures, severity-classified findings.
Time: 20-40 minutes
→ Go to Cognitive Design Checklist
Path 2: Run Visualization Audit
Choose this when: Evaluating data visualizations — charts, graphs, dashboards, infographics.
What you'll get: 1-5 scores on Clarity, Efficiency, Integrity, Aesthetics with pass/fail threshold.
Time: 15-30 minutes per visualization
→ Go to Visualization Audit Framework
Path 3: Combined Review
Choose this when: Comprehensive review covering both interface elements and data visualizations.
Process: Run Cognitive Checklist first, then Visualization Audit on each data component, merge findings, produce unified fix list.
Time: 45-90 minutes
→ Start with Cognitive Checklist, then Visualization Audit
Quick Reference
3-Question Rapid Check
1. Attention — "Is it obvious what to look at first?"
- If NO: hierarchy and visibility issues
2. Memory — "Is the user required to remember anything that could be shown?"
- If NO: memory support and chunking issues
3. Clarity — "Can someone unfamiliar understand in 5 seconds?"
- If NO: simplicity and comprehension issues
All YES = likely cognitively sound. Any NO = run full checklist on the failing area.
Guardrails
This skill does NOT: Create designs, teach theory, provide domain guidance, replace user testing, or cover full accessibility compliance.
This skill DOES: Provide systematic evaluation against cognitive principles, classify findings by severity, produce prioritized fix recommendations, and score visualization quality.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
synthesis-and-analogy
Use when synthesizing information from multiple sources (literature review, stakeholder feedback, research findings, data from different systems), creating or evaluating analogies for explanation or problem-solving (cross-domain transfer, "X is like Y", structural mapping), combining conflicting viewpoints into unified framework, identifying patterns across disparate sources, finding creative solutions by transferring principles from one domain to another, testing whether analogies hold (surface vs deep similarities), or when user mentions "synthesize", "combine sources", "analogy", "like", "similar to", "transfer from", "integrate findings", "what's it analogous to".
socratic-teaching-scaffolds
Use when teaching complex concepts (technical, scientific, philosophical), helping learners discover insights through guided questioning rather than direct explanation, correcting misconceptions by revealing contradictions, onboarding new team members through scaffolded learning, mentoring through problem-solving question frameworks, designing self-paced learning materials, or when user mentions "teach me", "help me understand", "explain like I'm", "learning path", "guided discovery", or "Socratic method".
environmental-scanning-foresight
Use when scanning external trends for strategic planning, monitoring PESTLE forces (Political, Economic, Social, Technological, Legal, Environmental), detecting weak signals (early indicators of change), planning scenarios for multiple futures, setting signposts and indicators for early warning, or when user mentions environmental scanning, horizon scanning, trend analysis, scenario planning, strategic foresight, futures thinking, or emerging issues monitoring.
embedding-fusion-strategy
Use when designing embedding strategies that fuse semantic and structural information for knowledge graphs. Invoke when user mentions node embeddings, structural embeddings, semantic embeddings, contrastive alignment, embedding fusion, vector representations for graphs, or combining text and graph signals. Provides embedding selection, fusion design, and implementation guidance.
constraint-based-creativity
Use when brainstorming feels stuck or generates obvious ideas, need to break creative patterns, working with limited resources (budget/time/tools/materials), want unconventional solutions, designing with specific limitations, user mentions "think outside the box", "we're stuck", "same old ideas", "tight constraints", "limited budget/time", or seeking innovation through limitation rather than abundance.
symmetry-group-identifier
Use when you've identified candidate symmetries and need to map them to mathematical groups for architecture design. Invoke when user mentions cyclic groups, dihedral groups, Lie groups, SO(3), SE(3), permutation groups, or needs to formalize symmetries into group theory language. Provides taxonomy and mathematical foundations from Visual Group Theory principles.
Didn't find tool you were looking for?