wiki-lint
Skill9 starsChanged 7 months agoMITView on GitHub
Health-check the Roblox/Luau wiki. Scans all pages for frontmatter validity, broken wikilinks, orphans, stale stubs, stale content, bidirectional link consistency, required sections, unresolved contradictions, index drift, and uncovered raw sources. Runs periodically or on demand.
43 other projects use a version of this.
Adopted by
Most recently taken up by
- tboome33/obsidian-mcp-routertheir own version, first seen Nov 15, 2026
- Ar9av/obsidian-wikitheir own version, first seen Nov 8, 2026
- ggoosen/Digital-Workforcetheir own version, first seen Nov 8, 2026
- barakgut/llm-wikitheir own version, first seen Nov 1, 2026
- chobizzy/llm-wikitheir own version, first seen Nov 1, 2026
- wareagledusty/wiki-federation-starter-kittheir own version, first seen Nov 1, 2026
Used with
Projects with it also use wiki-capture, wiki-status and 9 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
jehrhardtSkillwiki-capture
Quickly capture raw thoughts, links, images, or notes to today's Obsidian daily note from anywhere in Pi. Use when the user wants to jot something down for later wiki processing.
Also in 6 projects that use this
nexuschainsSkillwiki-status
Reports the current state of the wiki vault — page counts, category breakdown, hub pages, orphans, stale entries, and a delta showing what has changed since the last ingest. Use this skill when the operator asks "what's the status", "wiki dashboard", "how many pages", "what's stale", "what's been ingested", "show me the delta", or "wiki health overview". Also surfaces structural insights (top hubs, fragmented clusters, bridge pages) when the operator asks "wiki insights", "what's central", or "show me the hubs". Read-only: this skill reports and recommends; it does not modify any files.
Also in 5 projects that use this
nexuschainsSkillcross-linker
Scans the wiki vault and adds missing [[wikilinks]] between pages that are related but not yet connected. Use this skill when the operator says "link my pages", "find missing links", "cross-reference the wiki", "connect my wiki", "add wikilinks", or after any large ingest to weave new pages into the existing knowledge graph. Also trigger when orphaned pages need connecting or when wiki-lint reports fragmented tag clusters. This is a write-heavy skill — it modifies page files to insert links, unlike wiki-lint which only reports.
Also in 4 projects that use this
Ivy-Chen1999Skillwiki-synthesize
Systematically discover synthesis opportunities across the Obsidian wiki — pairs or clusters of concepts that co-occur frequently across pages but have no synthesis page connecting them. Creates new synthesis/ pages that draw explicit cross-cutting conclusions. Use when the user says "synthesize my wiki", "find connections", "what concepts keep coming up together", "/wiki-synthesize", or after a large ingest when the vault has grown significantly.
Also in 4 projects that use this
Ivy-Chen1999Skillwiki-setup
Initialize a new Obsidian wiki vault with the correct structure, special files, and configuration. Use this skill when the user wants to set up a new wiki from scratch, initialize the vault structure, create the .env file, or says things like "set up my wiki", "initialize obsidian", "create a new vault", "get started with the wiki". Also use when the user needs to reconfigure their existing vault or fix a broken setup.
Also in 5 projects that use this
bozhouDevSkillwiki-init
Use when bootstrapping a new personal wiki for any knowledge domain — research, codebase documentation, reading notes, competitive analysis, or any long-term knowledge accumulation project.
Also in 7 projects that use this
- +1 more from nexuschains
- +4 more from Ivy-Chen1999
Other versions43 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 43
- AgriciDaniel/claude-obsidian★ 16ksame name
- Ar9av/obsidian-wiki★ 3.7ksame name
- kfchou/wiki-skills★ 189same name
- IssacW228/student-llm-wiki★ 173same name
- vanillaflava/llm-wiki-skills★ 65same name
- cookyman74/llmwiki-harness★ 34same name
- SantaJordan/gtm-engineer-starter★ 33same name
- Ivy-Chen1999/llm-wiki-kit★ 21same name
- schub-tech/llm-ideation-wiki★ 11same name
- CarbeneAI/Forge★ 9same name
33 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository51 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- asset-auditSkill
- asset-from-imageSkill
- balance-checkSkill
- brainstormSkill
- bug-reportSkill
- changelogSkill
- code-reviewSkill
- datastore-reviewSkill
- design-reviewSkill
- design-systemSkill
- doctorSkill
- economy-auditSkill
- estimateSkill
- exploit-checkSkill
- gate-checkSkill
- gddSkill
- generate-assetSkill
- hotfixSkill
- launch-checklistSkill
- luau-lintSkill
- map-systemsSkill
- milestone-reviewSkill
- monetization-modelSkill
- onboardSkill
- patch-notesSkill
- perf-profileSkill
- project-stage-detectSkill
- prototypeSkill
- publish-reviewSkill
- release-checklistSkill
- remotes-auditSkill
- retention-analysisSkill
- retrospectiveSkill
- reverse-documentSkill
- scope-checkSkill
- sprint-planSkill
- startSkill
- studio-inspectSkill
- studio-screenshotSkill
- studio-testSkill
- team-combatSkill
- team-economySkill
- team-polishSkill
- team-releaseSkill
- team-uiSkill
- tech-debtSkill
- wiki-ingestSkill
- wiki-querySkill
- wiki-seedSkill
- wiki-updateSkill
The file
We split this skill into the rules it gives an agent
5 rules. 0 are common, 2 are distinctive, and 3 are very specific to this project.
0
Common
Most of the 34 edited versions we read keep these.
2
Distinctive
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 55
If it doesn't resolve, record as broken link
- Very specific: line 96
Not touched by any ingest since created (check wiki/log.md)
- Very specific: line 110
Search all pages for ⚠️ Contradiction flagged blocks.
- Very specific: line 247
If the user runs /wiki-lint --fix, offer to automatically fix these safe issues:
- Distinctive: line 261
Always present the auto-fix plan before applying, and require user approval.
“Common” is measured: kept by at least 6 in 10 of the 34 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
/wiki-lint — Wiki Health Check
Delegate to: wiki-curator
Prerequisites
- Wiki has been seeded (
wiki/index.mdexists) wiki/SCHEMA.mdexists
Workflow
1. Read the Schema
Load wiki/SCHEMA.md to know what "valid" means for each page type.
2. Enumerate All Wiki Files
find wiki/ -name "*.md" -not -path "wiki/raw/*" -type fThis gives every curated wiki page (Layer 2), excluding raw sources (Layer 1).
3. Run Each Check
For each check, collect findings into categorized buckets: Critical (blocks other operations), Error (invalid state), Warning (should fix), Info (nice to address).
Check 1: Frontmatter Validity (Critical → Error)
For each page, verify:
- File has frontmatter (
---block at top) title:present and non-emptytype:present and is one of: service, concept, luau-feature, anti-pattern, exploit, performance, monetization, studio, patterncategory:presentowner:present and refers to an agent that exists in.claude/agents/status:present and is one of: stub, draft, complete, needs-review, supersededcreated:present and is valid YYYY-MM-DDupdated:present and is valid YYYY-MM-DDupdated>=created
Failures: Critical.
Check 2: H1 Matches Title (Error)
First # heading must match title: in frontmatter (case-insensitive, ignoring trailing punctuation).
Check 3: Wikilink Integrity (Error)
Extract every [[Page Title]] or [[filename|Display]] wikilink. For each:
- Resolve to an actual file in
wiki/(try: exact filename match, title-to-slug match, case-insensitive match) - If it doesn't resolve, record as broken link
- Distinguish
[[wikilinks]](internal to wiki/) from[text](path)markdown links (can point anywhere)
Broken wikilinks: Error.
Check 4: Orphan Pages (Warning)
A page is an orphan if no other page in wiki/ links to it via wikilink.
Exceptions:
wiki/index.md,wiki/log.md,wiki/SCHEMA.md,wiki/README.md— root files, not orphans- Pages listed in
wiki/index.mdwith an explicit "orphan OK" flag
Orphan warning: Warning.
Check 5: Bidirectional Link Consistency (Warning)
For each page A, for each [[Page B]] link in A's ## Related section, verify Page B also has [[Page A]] in its ## Related section.
Missing back-links: Warning. Offer to auto-fix.
Check 6: Required Sections (Warning → Error)
For each page, based on its type:, verify it has the required sections from wiki/SCHEMA.md section 4.
servicerequires: Summary, API Surface, Budgets and Limits (optional for some), Common Patterns, Pitfalls, Related, Sourcesconceptrequires: What It Is, When to Use It, Implementation, Pitfalls, Related, Sourcesluau-featurerequires: Syntax, Semantics, Examples, Pitfalls, Related, Sourcesanti-patternrequires: What It Looks Like, Why It's Bad, How to Fix It, Detection, Related, Sourcesexploitrequires: Attack Vector, Affected Systems, Impact, Mitigation, Detection, Related, Sources- etc.
Pages with status: stub are allowed to have a reduced section set: Summary + TODO + Related + Sources. No error for stubs missing other sections.
Missing required sections on non-stub pages: Error.
Check 7: Stale Stubs (Warning)
A stub is stale if:
status: stubcreated> 30 days ago- Not touched by any ingest since
created(checkwiki/log.md)
Stale stub warning: Warning. List the stubs.
Check 8: Stale Content (Info)
A complete page is stale if:
status: completeupdated> 180 days ago
Stale content: Info. List the pages.
Check 9: Contradiction Blocks (Error)
Search all pages for ⚠️ Contradiction flagged blocks. Each unresolved contradiction is an Error — needs human review.
Check 10: Missing Cross-References (Info)
For each page, scan its body text for mentions of:
- Other existing pages (by title) that it doesn't link to in
## Related - Roblox class names that have their own service pages
- Concepts that have their own concept pages
Suggest adding those cross-references.
Check 11: Index Drift (Critical)
Compare:
- Set of pages that exist on disk (
find wiki/ -name "*.md" -not -path "wiki/raw/*") - Set of pages listed in
wiki/index.md
Report:
- Pages on disk but not in index (→ add to index)
- Pages in index but not on disk (→ remove from index or recreate the page)
Drift: Critical.
Check 12: Uncovered Raw Sources (Info)
Enumerate all files in wiki/raw/. For each, check if any wiki page's sources: frontmatter or body cites it. Raw files with zero citations in curated pages are "uncovered" — they're candidates for /wiki-ingest.
Uncovered raw: Info. List them.
Check 13: Owner Agent Validity (Error)
For each page's owner: field, verify the owner exists in .claude/agents/:
test -f .claude/agents/<owner>.mdInvalid owner: Error.
Check 14: Empty Related Section (Warning)
Pages with an empty ## Related section (or no ## Related at all) — warn unless the page is genuinely isolated (rare).
Check 15: Source Citation (Warning)
Pages with empty sources: frontmatter and no ## Sources section — warn. Every page should cite at least one raw source.
4. Compile Report
Format:
# Wiki Lint Report
**Date:** YYYY-MM-DD
**Pages checked:** N
**Raw sources checked:** M
## Summary
- Critical: X
- Error: X
- Warning: X
- Info: X
## Critical Issues
### Index Drift (X issues)
- `wiki/services/FooService.md` exists but not in index
- `wiki/concepts/bar-pattern.md` is in index but file missing
### Frontmatter Validity (X issues)
- `wiki/services/BazService.md`: missing `owner:` field
## Errors
### Broken Wikilinks (X issues)
- `wiki/concepts/session-locking.md` links to [[non-existent-page]]
- ...
### Required Sections (X issues)
- `wiki/exploits/speed-hack.md` missing "Mitigation" section
- ...
### Unresolved Contradictions (X issues)
- `wiki/services/DataStoreService.md` has contradiction block from 2026-04-14
### Invalid Owner (X issues)
- `wiki/services/Foo.md` owner "nonexistent-agent" not in .claude/agents/
## Warnings
### Orphan Pages (X)
- ...
### Missing Back-links (X)
- Page A → B but B doesn't link back to A
### Stale Stubs (X)
- `wiki/concepts/new-concept.md` stub since 2026-03-01 (45 days)
### Missing Cross-References (X)
- `wiki/services/DataStoreService.md` mentions `[[session-locking]]` but doesn't link it
## Info
### Stale Content (X)
- `wiki/services/HttpService.md` last updated 2025-10-05 (190+ days)
### Uncovered Raw Sources (X)
- `wiki/raw/community/articles/new-datastore-article.md` — candidate for /wiki-ingest
## Recommendations
1. Fix critical issues first (index drift, missing owners)
2. Resolve contradictions (delegate to owner agents)
3. Add missing back-links (batch-fix via /wiki-update)
4. Ingest uncovered raw sources via /wiki-ingest
5. Update stale content (review with domain owners)
## Next Steps
Run `/wiki-update <page>` to fix specific issues, or `/wiki-lint --fix` to auto-fix safe issues (back-links, cross-references, index drift) in a single pass.5. Append to log
## [YYYY-MM-DD] lint
- Pages checked: N
- Critical: X
- Errors: X
- Warnings: X
- Info: X
- Top issues: <1-3 bullets>6. Auto-Fix Mode (Optional)
If the user runs /wiki-lint --fix, offer to automatically fix these safe issues:
- Index drift — regenerate
wiki/index.mdfrom disk state - Missing back-links — add missing bidirectional Related links
- Missing cross-references — add wikilinks where the body mentions an existing page by name
- Frontmatter
updated:sync — if a page body was modified more recently thanupdated:claims, update it (requires git knowledge)
Auto-fix does NOT:
- Resolve contradictions
- Create missing pages
- Remove orphans
- Change page content beyond frontmatter and Related sections
- Modify raw sources
Always present the auto-fix plan before applying, and require user approval.
Anti-Patterns
- ❌ Do not silently fix anything without user approval
- ❌ Do not flag every possible issue — prioritize by severity
- ❌ Do not treat stubs as broken (stubs are first-class)
- ❌ Do not fail if a check can't run — skip with a warning
- ❌ Do not edit raw sources (Layer 1 is immutable)
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

