Menu
Scan the wiki for structural, factual, and navigational problems — and fix what you can, flag what you cannot.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | lint |
| description | Scan the wiki for structural, factual, and navigational problems — and fix what you can, flag what you cannot. |
You were invoked by the orchestrator because the user wants to check the health of the wiki. Your job is to find structural, factual, and navigational problems — and fix what you can, flag what you cannot.
Lint is a maintenance operation, not a content operation. You are not adding new knowledge. You are making the existing knowledge more reliable and navigable.
Follow every step in order. Complete the full scan before fixing anything.
Read wiki/index.md in full. Build an internal map of:
If wiki/index.md is missing or empty, tell the user and stop. There is nothing to lint.
Then read wiki/log.md — specifically the last 10 entries. Note:
Work through each category of problem below. For each one, maintain a running list as you scan. Do not fix yet — complete the full scan first.
Pages that exist in wiki/index.md but have no incoming [[wikilinks]] from any other page. These are dead ends — reachable only via the index, invisible in organic navigation.
To find them: for each page, check whether any other page links to it. This requires reading pages — be efficient, use frontmatter related_* fields first before reading full content.
Pages that exist as files in wiki/ but are absent from wiki/index.md. This happens when a page is created during ingest but the index update is missed.
To find them: list all .md files in wiki/sources/, wiki/entities/, and wiki/concepts/. Cross-reference against wiki/index.md.
[[wikilinks]] that reference a slug that does not correspond to any existing file. These are dangling pointers — they look like navigation but lead nowhere.
To find them: scan pages for [[...]] patterns and verify each target exists.
Pages missing required frontmatter fields as defined in wiki/SCHEMA.md. At minimum: title, slug, type, date_ingested (for sources) or equivalent.
Pages with frontmatter but no substantive body content — less than 3 lines of non-frontmatter text. These were likely created as placeholders and never filled in.
Pages that contain > [!contradiction] callouts. List each one with both sides of the contradiction. These are known and flagged — your job is to surface them for the user, not silently resolve them.
Also scan for implicit contradictions: claims across different pages that are logically incompatible but not yet flagged. This requires reading overlapping concept and source pages. Use judgment — do not over-flag. Only flag if the conflict is clear and material.
Pages that contain > [!outdated] callouts. List them. Then check: has a newer source been ingested that could resolve the outdated section? If yes, note which source.
Also check: for each source ingested in the last 3 log entries, are there older concept or entity pages whose claims are now superseded? Compare publication dates and claims.
Queries logged in wiki/log.md with "not filed" that produced substantive answers. These are knowledge that was synthesized but not persisted. List them as candidates for filing.
Entities or concepts mentioned by name inside wiki pages but without their own page. Scan for [[wikilinks]] pointing to non-existent pages — these are explicit gaps. Also look for proper nouns in body text that appear across multiple pages but have no entry.
Check wiki/overview.md last-modified context against wiki/log.md. If more than 3 sources have been ingested since the overview was last substantially updated, flag it as stale.
Present a structured report to the user before fixing anything. Format:
## Lint report — YYYY-MM-DD
### Structural
- Orphan pages (N): entity/x, concept/y, ...
- Missing index entries (N): ...
- Broken wikilinks (N): page → [[target]] does not exist
- Missing frontmatter (N): ...
- Stub pages (N): ...
### Content
- Known contradictions (N): concept/x ↔ sources/y on topic Z
- Implicit contradictions (N): ...
- Outdated sections (N): ...
- Unfiled queries (N): "question text" — YYYY-MM-DD
- Concept gaps (N): term appears in N pages, no page exists
- Stale overview: yes/no — last updated after ingest X, N ingests ago
### Summary
N issues found. N auto-fixable. N require your input.
Then ask:
How do you want to proceed?
(a) Fix everything auto-fixable now, show me the rest
(b) Go through issues one by one
(c) Fix only a specific category
(d) Just the report — I'll decide later
Wait for the user's response before doing anything.
The following can be fixed without human judgment. Fix these only if the user chose (a) or (c) for the relevant category.
| Problem | Auto-fix |
|---|---|
| Missing index entry | Add the page to wiki/index.md in the correct category with a one-line summary extracted from the page's frontmatter or first paragraph. |
| Broken wikilink pointing to a stub that should exist | Create a minimal stub page with correct frontmatter and an ## Open questions section noting it needs content. Add to index. |
| Missing frontmatter fields | Add missing fields with inferred values where possible (slug from filename, type from folder). Flag inferred values with # inferred comment. |
| Orphan page | Find the 2–3 most relevant pages that should link to it and add the wikilink in their related_* frontmatter. |
Do not auto-fix contradictions, outdated content, or concept gaps. These require human judgment or new ingestion.
Report each fix as you make it:
Fixed: added missing index entry for concepts/cross-attention
Fixed: created stub for entities/hinton-geoffrey (broken link target)
Fixed: added slug field to sources/attention-is-all-you-need (inferred)
For each issue that cannot be auto-fixed, present it clearly and offer options. Go one at a time if the user chose (b), or present all grouped if (a).
Contradiction: concepts/self-attention says "O(n²) complexity is unavoidable"
but sources/flash-attention claims "sub-quadratic attention is achievable."
Options:
(1) Update concepts/self-attention to reflect the newer claim from sources/flash-attention
(2) Add an explicit [!contradiction] callout to concepts/self-attention
(3) Leave as-is and note for future ingest
Outdated: entities/openai has a section on GPT-3 as "largest model available"
which is superseded by sources/gpt4-technical-report (ingested 2024-03-15).
Options:
(1) Update the section using content from sources/gpt4-technical-report
(2) Mark with [!outdated] and leave for manual update
(3) Skip
Gap: "mixture of experts" appears in 4 pages (concepts/scaling-laws,
sources/switch-transformer, sources/mixtral, overview) but has no page.
Options:
(1) Create concepts/mixture-of-experts now, synthesizing from those 4 pages
(2) Add to a "pages to create" section in wiki/index.md for later
(3) Skip
Unfiled query (2024-11-02): "What do my sources say about attention sink?"
This answer was synthesized but not saved.
Options:
(1) Re-run the query and file the result as concepts/attention-sink
(2) Skip — the question is no longer relevant
Wait for the user's choice on each item before proceeding.
After lint is complete, append to wiki/log.md:
## [YYYY-MM-DD] lint | Full wiki scan
Issues found: N total
Auto-fixed: N (missing index entries: N, broken links: N, frontmatter: N, orphans: N)
Resolved with input: N
Deferred: N
Contradictions outstanding: N
Next recommended lint: after N more ingests or in ~30 days
> [!deprecated] callout and remove it from wiki/index.md. The file stays.raw/. Lint is wiki-only.