agentleFS
IssacW228IssacW228/student-llm-wiki/.github/skills/wiki-lint/SKILL.md

wiki-lint

Skill173 starsChanged 5 months agoMITView on GitHub

Health-check the wiki and apply confidence decay. This skill should be used when the user says "lint", "检查wiki", "check the wiki", or wants to find orphan pages, broken links, contradictions, or stale concepts. Runs the 30-day confidence decay rule and reports issues for the user to fix.

42 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use wiki-capture, wiki-status and 10 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.
  • jehrhardtSkill

    wiki-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

  • nexuschainsSkill

    wiki-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

  • nexuschainsSkill

    cross-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-Chen1999Skill

    wiki-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-Chen1999Skill

    wiki-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

  • bozhouDevSkill

    wiki-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

The file

Files
SKILL.md

Wiki Lint

健康检查知识库。 Health-check the knowledge base.

检查项 Checks

  1. 孤立页 Orphans: 没有任何 [[链接]] 指向的概念页
  2. 断链 Broken links: [[链接]] 指向不存在的页面
  3. 矛盾 Contradictions: 不同页面对同一概念的冲突描述。同时写入 wiki/contradictions.md(用 wiki-ingest 中的矛盾记录格式)并更新 overview.md 的矛盾摘要
  4. 陈旧内容 Stale: confidence:low 且长期未更新的页面
  5. Confidence 衰减 Decay:
    • 若概念页 last_reviewed 距今 >30天,且期间未被新页面引用 → confidence 降一级(high→medium→low)
    • 列出所有降级的概念
  6. 跨课程缺失 Missing links: 同一概念出现在多门课但没有互链
  7. 课程总览缺失 Missing overviews: index.md 中每门课是否都有对应的 wiki/courses/{course}-overview.md;缺少则自动创建(用 wiki-ingest 中的课程总览页格式)
  8. 术语表缺失 Glossary gaps: 检查 wiki/glossary.md 中缺少哪些已有概念页的术语条目,补充完整

流程 Process

  1. 读 wiki/index.md 获取所有页面列表
  2. 按需读取页面检查(遵守token预算,分批检查)
  3. 报告发现,询问用户要修复哪些(不要自动全改)
  4. 修复后,批量维护(无需用户确认,直接更新):
    • wiki/courses/{course}-overview.md(缺少的课程总览页直接新建)
    • wiki/glossary.md(补充缺失的术语条目)
    • wiki/contradictions.md(追加新发现的矛盾)
    • wiki/connections-log.md(补录缺失的跨课连接)
    • wiki/overview.md(同步更新矛盾摘要、连接摘要、课程列表)
    • wiki/log.md(追加格式: ## {YYYY-MM-DD} — lint: 孤立N 断链N 衰减N 矛盾N 补连N 补总览N 补术语N)

报告格式 Report

🏝️ 孤立页 (N): ...
🔗 断链 (N): ...
⚡ 矛盾 (N): ...
📉 衰减降级 (N): [概念] high→medium (45天未复习)
🌉 缺失跨课连接 (N): [概念A] 和 [概念B] 应互链
📂 缺失课程总览 (N): wiki/courses/{course}-overview.md
📖 术语表缺失条目 (N): [概念名]

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.