| name | repo-wiki-validate |
| description | Validate wiki quality and enforce gates. Checks citation validity, link integrity, formatting consistency, and coverage requirements before merging. |
| license | MIT |
| compatibility | Requires uv (Python package manager), markdown linting tools optional |
| metadata | {"version":"1.0.0","parent_skill":"repo-wiki","category":"documentation-validation"} |
| allowed-tools | cat ls uv git |
Repo Wiki Validate Skill
Enforce quality gates and validate wiki integrity.
Purpose
This skill performs comprehensive validation:
- Citation validation - All citations resolve to valid files and line ranges
- Link checking - Internal links point to existing pages
- Format validation - Markdown syntax correct, managed blocks closed
- Coverage validation - Technical claims have citations
- Build verification - MkDocs builds without errors
When to Use
Use this skill:
- Before committing documentation changes
- After any documentation update
- In CI/CD pipelines as quality gate
Validation Checks
1. Citation Validity
uv run skills/repo-wiki/scripts/validate_citations.py
2. Internal Links
Check all markdown links resolve to existing pages.
3. Markdown Syntax
Verify no unclosed code blocks or managed blocks.
4. MkDocs Build
mkdocs build --strict
Success Criteria
- ✅ All citations resolve
- ✅ No broken links
- ✅ Markdown syntax valid
- ✅ MkDocs builds
- ✅ Coverage ≥80%
Output
.repo_wiki/validation_report.md - Detailed report- Exit code 0 (pass) or 1 (fail)
