Review Workflow

Overview

1. skill-validator - Pass/fail quality gate (minimum standards)
2. review-multi - Comprehensive multi-dimensional review (1-5 scoring)
3. skill-tester - Functional testing in real scenarios

When to Use

• Pre-deployment quality assurance (complete validation before release)
• Comprehensive quality checks (all aspects validated)
• Certification process (validate skill meets all standards)
• Major update validation (ensure quality maintained after changes)
• Quality audit (periodic comprehensive checks)

Review Workflow

Step 1: Quality Gate Validation (skill-validator)

1. Run skill-validator on skill
2. Check all 4 validation operations:
   • Structure validation
   • Content validation
   • Pattern validation
   • Production readiness
3. Result: PASS or FAIL

• PASS → Proceed to Step 2 (comprehensive review)
• FAIL → Stop, fix critical issues, re-run Step 1

• Validation report (pass/fail)
• Critical issues list (if failed)
• Go/no-go decision

Step 2: Comprehensive Review (review-multi)

1. Run all 5 review operations:
   • Operation 1: Structure Review (5-10 min, automated)
   • Operation 2: Content Review (15-30 min, manual)
   • Operation 3: Quality Review (20-40 min, mixed)
   • Operation 4: Usability Review (30-60 min, manual testing)
   • Operation 5: Integration Review (15-25 min, manual)
2. Calculate weighted overall score
3. Map to grade (A/B/C/D/F)
4. Assess production readiness
5. Generate improvement recommendations

• Overall score (1.0-5.0)
• Grade (A/B/C/D/F)
• Per-dimension scores
• Production readiness assessment
• Prioritized improvement recommendations

Step 3: Functional Testing (skill-tester)

1. Run testing operations:
   • Scenario Testing (test in realistic use case)
   • Example Validation (verify examples execute)
   • Integration Testing (test with other skills if applicable)
   • Usability Testing (assess ease of use)
2. Document test results
3. Identify any functional issues

• Scenario test results (success/failure)
• Example validation results (all pass/some fail)
• Integration test results
• Usability assessment
• Functional issues list (if any)

Post-Workflow: Deployment Decision

Aggregate Results

• PASS/FAIL status
• Critical issues (if any)

• Overall score: X.X/5.0
• Grade: A/B/C/D/F
• Production readiness assessment
• Improvement recommendations

• Scenario tests: Pass/Fail
• Examples: All working/Some broken
• Integration: Working/Issues
• Usability: Good/Needs improvement

Make Deployment Decision

• Quality Gate: PASS
• Overall Score: ≥4.5 (Grade A)
• Functional Tests: All passing
• Action: Deploy to production

• Quality Gate: PASS
• Overall Score: 4.0-4.4 (Grade B+)
• Functional Tests: Passing
• Action: Deploy, note improvements for next iteration

• Quality Gate: PASS
• Overall Score: 3.5-3.9 (Grade B-)
• OR Functional Tests: Some failures
• Action: Fix identified issues, re-run workflow

• Quality Gate: FAIL
• OR Overall Score: <3.5 (Grade C-F)
• OR Functional Tests: Major failures
• Action: Significant rework required

Best Practices

1. Always Run Complete Workflow

2. Fix Critical Issues Immediately

3. Document All Findings

4. Apply Improvements Iteratively

5. Re-Run After Major Changes

Quick Reference

The 3-Step Review Workflow

Workflow Pattern

skill-validator (Quality Gate)
    ↓
  PASS? ──No──> Fix issues, retry
    ↓ Yes
review-multi (Comprehensive Review)
    ↓
Overall Score + Grade + Recommendations
    ↓
skill-tester (Functional Testing)
    ↓
Test Results + Usability Assessment
    ↓
Deployment Decision (Deploy/Hold/Rework)

Deployment Decision Matrix

Integration with Development

Build skill (development-workflow) →
Review workflow (this skill) →
Apply improvements (skill-updater) →
Re-validate (review-workflow) →
Deploy