boweneos 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)