# Wiki Audit

> Verify per-page that every ^[raw/...] resolves and sources frontmatter matches the body.

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

---


# wiki-audit

## When This Skill Activates

- User asks for a per-page audit or invokes a pre-merge gate.
- A vault is resolvable (see step 0).

## Output language

Run `skillwiki lang` at the start. Generate audit narrative and `--human` summaries in the resolved language. Frontmatter keys, file names, schema headers, index/log structural lines, citation markers, and wikilink slugs MUST stay English.

## Pre-orientation reads
Standard four reads.

## Steps
0. **Resolve vault and language.** Run `skillwiki path` (fail if NO_VAULT_CONFIGURED) and `skillwiki lang`.
1. `skillwiki audit <page>`. Read the JSON report.
2. Reason over the report:
   - Resolve citations against active `raw/`, `raw/archived/`, `raw/duplicates/`, and append-only relocation history. Legacy `_archive/raw/` is read-compatible only, not a valid new destination.
   - For each unresolved marker: distinguish a genuinely missing target from a stale historical path, then suggest ingesting the missing source or correcting maintained-page metadata.
   - For each `unused_sources` entry: suggest adding a body marker or removing from `sources:`.
   - For each `missing_from_sources` entry: suggest adding to `sources:`.
3. Append one `log.md` entry summarizing the audit and any suggested follow-ups.

## Stop conditions
None — audit always completes.

## Forbidden
- Auto-applying suggested fixes (audit is observation-only).
- Rewriting raw evidence while repairing an audit finding.