Skill
Community

quality-standards

Install
1
Install the plugin
$
npx claudepluginhub Claude-Code-Community-Ireland/claude-code-resources --plugin vibeworks-library

Want just this skill?

Then install: npx claudepluginhub u/[userId]/[slug]

Description

Quality gate definitions, scoring rubrics, and acceptance criteria for the Agentic UI Designer system.

Tool Access

This skill uses the workspace's default tool permissions.

Skill Content

Quality Standards Reference

This skill defines the quality gates, scoring criteria, and acceptance standards that all designs must meet.

Quality Gates (95% MINIMUM)

All gates must pass for design completion:

GateThresholdWeightMandatory
Minimum Iterations>= 5-Yes
Maximum Iterations<= 20-Yes
Overall Score>= 9.5/10 (95%)-Yes
WCAG AA Compliance100%-Yes
Vibe-Code Probability< 1%-Yes
Critical Issues0-Yes
Spatial Score>= 9.0/1025%Yes
Color Score>= 9.0/1025%Yes
Typography Score>= 9.0/1025%Yes
Originality Score>= 9.5/1025%Yes

Scoring Rubrics

Spatial Design (0-10)

ScoreDescription
9-10Perfect grid adherence, masterful spacing relationships, balanced composition
7-8Consistent grid usage, good spacing, minor alignment issues
5-6Some grid violations, inconsistent spacing, noticeable balance issues
3-4Frequent off-grid values, poor spacing relationships, unbalanced
1-2No grid system, chaotic spacing, severely unbalanced

Key Checkpoints:

  • All spacing values on 8pt grid (or 4pt for micro)
  • Consistent spacing between similar elements
  • Logical spacing hierarchy (related closer, unrelated farther)
  • Proper alignment to grid columns
  • Balanced visual weight distribution
  • Effective use of whitespace

Color Design (0-10)

ScoreDescription
9-10WCAG AAA, harmonious palette, strong emotional alignment, unique
7-8WCAG AA, cohesive colors, appropriate mood, some customization
5-6Minor contrast issues, acceptable harmony, generic choices
3-4WCAG failures, clashing colors, wrong emotional tone
1-2Multiple accessibility failures, no coherent palette

Key Checkpoints:

  • All text/background combinations meet WCAG AA (4.5:1)
  • UI components meet 3:1 contrast
  • Color palette is harmonious (defined relationship)
  • Colors evoke intended emotional response
  • Colors are appropriate for sector
  • Palette is not generic/default framework colors

Typography (0-10)

ScoreDescription
9-10Perfect hierarchy, excellent readability, intentional pairing, flawless implementation
7-8Clear hierarchy, good readability, appropriate fonts, minor issues
5-6Adequate hierarchy, acceptable readability, basic font choices
3-4Unclear hierarchy, readability issues, poor font choices
1-2No hierarchy, unreadable, inappropriate fonts

Key Checkpoints:

  • Clear visual hierarchy (size, weight, color)
  • Font pairing is intentional and complementary
  • Line length 50-75 characters
  • Line height appropriate (1.4-1.6 for body)
  • Minimum 16px for body text
  • Consistent usage across similar elements
  • Proper CSS implementation (rem, variables)

Originality (0-10)

ScoreDescription
9-10Highly unique, no generic patterns, strong brand personality
7-8Mostly original, minimal generic patterns, some personality
5-6Some customization, recognizable generic patterns
3-4Mostly generic, obvious AI patterns, no personality
1-2Pure vibe-code, all defaults, completely generic

Key Checkpoints:

  • No generic gradients (purple-blue, etc.)
  • Layout patterns customized from stock
  • Framework defaults modified
  • Decorative elements are purposeful
  • Real content (not placeholder)
  • Distinct brand personality present

WCAG 2.1 Checklist

Level A (Must Pass)

CriterionDescriptionCheck
1.1.1Non-text content has alt textImages, icons
1.3.1Info and relationships in markupSemantic HTML
1.3.2Meaningful sequenceDOM order matches visual
1.4.1Color not sole indicatorDon't rely on color alone
2.1.1Keyboard accessibleAll functionality via keyboard
2.1.2No keyboard trapCan tab away from all elements
2.4.1Bypass blocksSkip links present
2.4.2Page titledDescriptive title
2.4.4Link purpose clearFrom link text or context
3.1.1Language of pagelang attribute on html
4.1.1Valid markupNo parsing errors
4.1.2Name, role, valueARIA where needed

Level AA (Should Pass)

CriterionDescriptionCheck
1.4.3Contrast minimum4.5:1 normal, 3:1 large
1.4.4Resize textWorks at 200% zoom
1.4.5Images of textAvoid, use real text
2.4.6Headings descriptiveClear, meaningful
2.4.7Focus visibleClear focus indicators
3.2.3Consistent navigationSame order throughout
3.2.4Consistent identificationSame function = same name

Level AAA (Recommended)

CriterionDescriptionCheck
1.4.6Enhanced contrast7:1 normal, 4.5:1 large
1.4.8Visual presentationLine length, spacing
2.4.9Link purpose aloneClear from link text only

Issue Classification

Critical (Blocks Deployment)

  • WCAG Level A failures
  • Color contrast below 3:1
  • Broken core functionality
  • Unreadable text
  • Keyboard traps
  • Missing skip links

High Priority (Fix Before Launch)

  • WCAG Level AA failures
  • Color contrast 3:1-4.5:1 (below AA)
  • Significant layout issues
  • Poor visual hierarchy
  • Major spacing inconsistencies
  • No focus indicators

Medium Priority (Fix Soon)

  • Minor spacing issues
  • Suboptimal color choices
  • Typography tweaks
  • Enhancement opportunities
  • WCAG AAA suggestions

Low Priority (Nice to Have)

  • Micro-interaction polish
  • Animation refinements
  • Advanced accessibility features
  • Performance optimizations

Iteration Strategy

Explore Phase (Iterations 1-5)

  • Try bold, different approaches
  • Don't optimize prematurely
  • Focus on overall direction
  • MUST complete all 5 iterations even if gates pass early
  • Use early passing to polish and exceed thresholds

Exploit Phase (Iterations 6-12)

  • Refine the best approach
  • Fix specific issues identified
  • Optimize for quality gates
  • Polish and perfect

Pivot Phase (Iterations 13-20)

  • If stuck, try completely different direction
  • Re-run research with new direction
  • Reset assumptions
  • Challenge previous decisions
  • Consider alternative approaches

Score Calculation

Overall Score = (Spatial × 0.25) + (Color × 0.25) +
                (Typography × 0.25) + (Originality × 0.25)

Pass Criteria:
- Minimum iterations >= 5
- Overall >= 9.5 (95%)
- All dimensions >= 9.0
- Originality >= 9.5
- Vibe-code probability < 1%
- Critical issues = 0
- WCAG AA = 100%

Failure Patterns

Score Plateau

Detection: No improvement for 2+ iterations Action: Switch to Pivot strategy, try different approach

Recurring Issues

Detection: Same issues appear after "fixing" Action: Address root cause, not symptoms

Regression

Detection: Scores decreasing Action: Revert to previous best, analyze what broke

Dimension Imbalance

Detection: One dimension consistently low Action: Focused iteration on weak dimension

Stats
Stars2
Forks0
Last CommitJan 29, 2026

Similar Skills