# Wiki Lint

> Run semantic wiki lint beyond structural link checks. Use when the user asks to audit, lint, health-check, find stale claims, find unsupported claims, check provenance, or identify contradictions in the wiki.

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

---


Run a semantic lint pass over the business-idea wiki. This complements the Notion helper checks in `docs/agent/workflows.md`; it does not replace them.

**Start with deterministic checks.**

1. Run the deterministic Notion helper checks from `docs/agent/workflows.md`.
2. Read `hot.md`, `wiki/index.md`, and the relevant Notion idea page before reading deep-dive pages.

**Semantic checks.** For each idea, inspect the overview and its related deep-dive notes for:

- **Unsupported material claims.** Any statistic, price, legal statement, named competitor claim, market-size claim, or dated event must have a raw-source line citation.
- **Unmarked synthesis.** Claims that are inferred from multiple sources, not directly stated by one source, should carry `^[inferred]`.
- **Ambiguity drift.** Contested or weak claims should carry `^[ambiguous]` and should not be written as settled.
- **User-only premises.** Founder assertions, anecdotes, and "everyone says yes" style evidence should carry `^[user-claim]` unless independently validated.
- **Risk/verdict mismatch.** If a risk could kill the idea, the verdict and Next moves must reflect it.
- **Answered validations.** If a `Still to validate` item is already answered in a deep-dive or raw note, update or remove it.
- **Stale claims.** Pages older than 90 days should be checked for date-sensitive claims before being treated as current.
- **Mapping mismatch.** Notion pages that should be script-addressable should either be added to `notion.config.json` or explicitly left as manually navigated child pages.
- **Prose bloat.** Flag any sentence over ~20 words, any bullet carrying two claims, and any run of more than ~3 sentences of prose. Rewrite to the `## Output` rules in `AGENTS.md`.

**Report format.** Lead with the highest-severity findings:

```markdown
## Semantic Lint

### P1
- [Page](path) — claim/risk. Why it matters. Suggested fix.

### P2
- ...

### Maintenance
- Mapping/index/log/hot-cache updates needed.
```

Use priorities this way:

- **P1:** Could change the verdict or invalidate a next move.
- **P2:** Material but not immediately verdict-changing.
- **P3:** Hygiene, clarity, or future retrieval quality.

If the user asked you to fix issues, edit the Notion wiki directly, then run the ritual (`AGENTS.md` § Mechanics).