Validate wiki quality and enforce gates. Checks citation validity, link integrity, formatting consistency, and coverage requirements before merging.
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)
You Might Also Like
Related Skills
update-docs
This skill should be used when the user asks to "update documentation for my changes", "check docs for this PR", "what docs need updating", "sync docs with code", "scaffold docs for this feature", "document this feature", "review docs completeness", "add docs for this change", "what documentation is affected", "docs impact", or mentions "docs/", "docs/01-app", "docs/02-pages", "MDX", "documentation update", "API reference", ".mdx files". Provides guided workflow for updating Next.js documentation based on code changes.
vercel
docstring
Write docstrings for PyTorch functions and methods following PyTorch conventions. Use when writing or updating docstrings in PyTorch code.
pytorch
docs-writer
Always use this skill when the task involves writing, reviewing, or editing files in the `/docs` directory or any `.md` files in the repository.
google-gemini
write-concept
Write or review JavaScript concept documentation pages for the 33 JavaScript Concepts project, following strict structure and quality guidelines
leonardomsoresource-curator
Find, evaluate, and maintain high-quality external resources for JavaScript concept documentation, including auditing for broken and outdated links
leonardomso
doc-coauthoring
Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.
anthropics