ReddRadar
Agent skill
nw-quality-validation
Type-specific validation checklists, six quality characteristics, and quality gate thresholds for documentation assessment
Install this agent skill to your Project
npx add-skill https://github.com/nWave-ai/nWave/tree/main/plugins/nw/skills/nw-quality-validation
SKILL.md
Quality Validation
Six Quality Characteristics
- Accuracy: Factually correct, technically sound, current | Validation: expert review, automated testing
- Completeness: All necessary info present for doc type | Validation: checklist, gap analysis
- Clarity: Easy to understand, logical flow, appropriate level | Validation: Flesch 70-80
- Consistency: Uniform terminology, formatting, structure | Validation: style guide compliance
- Correctness: Proper grammar, spelling, punctuation | Validation: automated check, zero errors
- Usability: User achieves goal efficiently | Validation: task success, DIVIO type purpose served
Quality Gate Thresholds
| Metric | Threshold |
|---|---|
| Readability (Flesch) | 70-80 |
| Spelling errors | 0 |
| Broken links | 0 |
| Style compliance | 95%+ |
| Type purity | 80%+ single type |
Type-Specific Validation Checklists
Tutorial Checklist
- Completable without external references | [ ] Steps numbered and sequential
- Each step has verifiable outcome | [ ] No assumed prior knowledge | [ ] Builds confidence
How-to Checklist
- Clear goal stated upfront | [ ] Assumes fundamentals known
- Single task focus | [ ] Ends with completion indicator | [ ] No basics teaching
Reference Checklist
- All parameters documented | [ ] Return values specified
- Error conditions listed | [ ] Examples per entry | [ ] No narrative
Explanation Checklist
- Addresses "why" not "what" | [ ] Provides context and reasoning
- Discusses alternatives | [ ] No task steps | [ ] Builds conceptual model
Verdict Criteria
- approved: Passes all type-specific validation, no collapse violations, meets quality gates
- needs-revision: Minor issues fixable in place (clarity, missing examples, small gaps)
- restructure-required: Collapse detected requiring split, or fundamental type mismatch
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
nWave-ai/nWave
nw-research
Gathers knowledge from web and files, cross-references across multiple sources, and produces cited research documents. Use when investigating technologies, patterns, or decisions that need evidence backing.
nWave-ai/nWave
nw-distill
Acceptance test creation methodology for the DISTILL wave. Domain knowledge for the acceptance designer agent: port-to-port principle, prior wave reading, wave-decision reconciliation, graceful degradation, and document back-propagation.
nWave-ai/nWave
nw-review-output-format
YAML output format and approval criteria for platform design reviews. Load when generating review feedback.
nWave-ai/nWave
nw-ddd-tactical
Tactical DDD — aggregate design rules, entities, value objects, domain events, repositories, domain services, and anti-pattern detection
nWave-ai/nWave
nw-infrastructure-and-observability
Infrastructure as Code patterns (Terraform, Kubernetes), observability design (SLOs, metrics, alerting, dashboards), and pipeline security stages. Load when designing infrastructure, observability, or security scanning.
nWave-ai/nWave
nw-par-critique-dimensions
Platform design review critique dimensions and severity levels. Load when reviewing CI/CD pipelines, infrastructure, deployment strategies, observability, or security designs.
Didn't find tool you were looking for?