wiki-lint
Wiki Lint performs comprehensive health checks on your knowledge base, identifying orphaned pages, broken internal links, contradictory information, and stale content that needs updating. It applies a 30-day confidence decay rule to flag concepts that haven't been reviewed, detects missing cross-course connections, and ensures course overviews and glossary entries are complete. After scanning, it prompts you to choose which issues to fix, then automatically updates all related documentation.
Wiki Lint runs automated health checks on your knowledge base to identify orphaned pages, broken links, stale content, and confidence decay.
AI-generated summary based on this skill's SKILL.md
Install
IssacW228/student-llm-wiki/wiki-lint
git clone https://github.com/IssacW228/student-llm-wiki
cp -r student-llm-wiki/skills/wiki-lint ~/.claude/skills/wiki-lintFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What does wiki-lint do?
Wiki Lint performs comprehensive health checks on your knowledge base, identifying orphaned pages, broken internal links, contradictory information, and stale content that needs updating. It applies a 30-day confidence decay rule to flag concepts that haven't been reviewed, detects missing cross-course connections, and ensures course overviews and glossary entries are complete. After scanning, it prompts you to choose which issues to fix, then automatically updates all related documentation.
How do I check wiki-lint for broken links?
Wiki Lint automatically scans your entire knowledge base to find broken internal links as part of its core health check. When you run wiki-lint, it identifies all links that point to non-existent pages or invalid references. The tool then generates an audit report showing each broken link's location and target, allowing you to review and confirm fixes before wiki-lint updates your documentation.
Can wiki-lint find orphan pages in my knowledge base?
Yes. Wiki Lint detects orphaned pages—content that exists but has no incoming links from other wiki pages. This helps identify isolated or forgotten documentation. The tool flags these pages in its audit report so you can decide whether to link them into your knowledge base structure, update them, or remove them entirely.
What is confidence decay and how does wiki-lint use it?
Wiki Lint applies a 30-day confidence decay rule to identify pages needing review. Any concept or page that hasn't been reviewed within 30 days is flagged as potentially stale. This helps you maintain current, accurate documentation by surfacing content that may be outdated or require validation before being trusted as authoritative.
Does wiki-lint detect contradictions in my wiki?
Yes. Wiki Lint detects contradictions and missing connections across wiki pages, scanning for conflicting information and incomplete cross-course links. It validates glossary entries, course overviews, and ensures all related documentation is consistent. When contradictions are found, they appear in the audit report for your review and correction.
What happens after wiki-lint completes its scan?
Wiki Lint generates an audit report listing all issues found: broken links, orphaned pages, stale content, contradictions, and missing connections. You review the report and choose which issues to fix. Once you confirm, wiki-lint automatically updates all related documentation to resolve the selected problems, maintaining your wiki's integrity throughout the process.
SKILL.md
rendered from the published skill — quoted content, verbatim
Wiki Lint
健康检查知识库。 Health-check the knowledge base.
检查项 Checks
- 孤立页 Orphans: 没有任何
[[链接]]指向的概念页 - 断链 Broken links:
[[链接]]指向不存在的页面 - 矛盾 Contradictions: 不同页面对同一概念的冲突描述。同时写入
wiki/contradictions.md（用 wiki-ingest 中的矛盾记录格式）并更新overview.md的矛盾摘要 - 陈旧内容 Stale: confidence:low 且长期未更新的页面
- Confidence 衰减 Decay:
- 若概念页
last_reviewed距今 >30天，且期间未被新页面引用 → confidence 降一级（high→medium→low） - 列出所有降级的概念
- 跨课程缺失 Missing links: 同一概念出现在多门课但没有互链
- 课程总览缺失 Missing overviews:
index.md中每门课是否都有对应的wiki/courses/{course}-overview.md；缺少则自动创建（用 wiki-ingest 中的课程总览页格式） - 术语表缺失 Glossary gaps: 检查
wiki/glossary.md中缺少哪些已有概念页的术语条目，补充完整
流程 Process
- 读
wiki/index.md获取所有页面列表 - 按需读取页面检查（遵守token预算，分批检查）
- 报告发现，询问用户要修复哪些（不要自动全改）
- 修复后，批量维护（无需用户确认，直接更新）：
wiki/courses/{course}-overview.md（缺少的课程总览页直接新建） -
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
skills/wiki-lint/SKILL.md