# Repo Wiki Validate

> Validate wiki quality and enforce gates. Checks citation validity, link integrity, formatting consistency, and coverage requirements before merging.

- Skill: `boweneos/repo-wiki-validate` (Agent Skill)
- Install (CLI): `npx skillmds@latest add boweneos/repo-wiki-validate`
- Raw SKILL.md: https://api.skillmd.com/api/skills/boweneos/repo-wiki-validate/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- License: MIT
- Author: boweneos (https://skillmd.com/u/boweneos)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/boweneos/repo-wiki-validate

---


# Repo Wiki Validate Skill

Enforce quality gates and validate wiki integrity.

## Purpose

This skill performs comprehensive validation:

1. **Citation validation** - All citations resolve to valid files and line ranges
2. **Link checking** - Internal links point to existing pages
3. **Format validation** - Markdown syntax correct, managed blocks closed
4. **Coverage validation** - Technical claims have citations
5. **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

```bash
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

```bash
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)