# Nw Quality Validation

> Type-specific validation checklists, six quality characteristics, and quality gate thresholds for documentation assessment

- Skill: `thedixitjain/nw-quality-validation` (Agent Skill)
- Install (CLI): `npx skillmds add thedixitjain/nw-quality-validation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/thedixitjain/nw-quality-validation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: thedixitjain (https://skillmd.com/u/thedixitjain)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/thedixitjain/nw-quality-validation

---



# 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

---

**Source:** [`nWave-ai/nWave`](https://github.com/nWave-ai/nWave) → `nWave/skills/nw-quality-validation/SKILL.md`

**Also appears in:** `nWave-ai/nWave/plugins/nw/skills/nw-quality-validation/SKILL.md`