agentleFS
VastFutureVastFuture/llm-wiki-skills/skills/wiki-lint/SKILL.md

wiki-lint

Skill0 starsChanged 3 months agoMITView on GitHub

LLM Wiki 知识库健康巡检。检查页面矛盾、过时主张、孤立页面、缺少入链、缺失交叉引用、 可搜索填补的数据空白。输出巡检报告,提出改进建议。触发词:检查知识库、wiki体检、巡检。

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 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.
  • 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-update

    Use when revising existing wiki pages because knowledge has changed, a new piece of information updates or contradicts existing content, or the user wants to directly edit wiki content with LLM assistance.

    Also in 7 projects that use this

  • +1 more from nexuschains
  • +4 more from Ivy-Chen1999

The file

Files
SKILL.md

/wiki-lint — 健康巡检

定期检查 LLM Wiki 知识库的健康状况,输出报告。

定期检查 LLM Wiki 知识库的健康状况,输出报告。

执行前置步骤

步骤 0:读取配置

  1. 读取配置文件:
    • 优先项目模式:检查当前目录是否存在 wiki-config.json(scope: "project")
    • 全局模式:~/.config/opencode/wiki-config.json(scope: "global")
  2. 从配置中获取 kbPath(知识库根目录)
  3. 若配置不存在或 kbPath 为空,提示用户先执行 /wiki-init 初始化知识库
  4. wiki/ 目录即 {kbPath}/wiki/,raw/ 即配置中的 rawPath

步骤 1:自动分类(classify)

  1. 使用 Skill 工具加载 wiki-classify skill
  2. 完整执行其定义的分类流程
  3. classify 完成后继续巡检流程

扫描范围

  • wiki/:{kbPath}/wiki/ 下全部 .md 文件和 .canvas 文件
  • raw/:{rawPath} 下全部子目录中的 .md 文件(含 raw/Clippings/ 等)
  • 排除:assets/(仅图片资源,无需扫描)

检查项目

1. 页面矛盾

  • 搜索 wiki 中互相矛盾的断言
  • 标注矛盾位置和建议修正方向

2. 过时主张

  • 检查被新资料取代的旧主张
  • 标注需要更新的页面

3. 孤立页面

  • 搜索无入链的页面(无其他页面引用)
  • 建议添加交叉引用或合并

4. 缺失页面

  • 被提及但缺乏独立页面的重要概念
  • 建议创建新页面

5. 缺失交叉引用

  • 相关内容未建立 wikilink 链接
  • 建议添加关联

6. 数据空白

  • 可通过网络搜索填补的知识空白
  • 建议搜索方向和关键词

7. Raw 覆盖率

  • 检查 {rawPath} 所有子目录中的 .md 文件是否都有对应的 {kbPath}/wiki/摘要/ 页面
  • 列出未摄入的 raw 文件
  • 排除 assets/ 目录

输出格式

## 巡检报告 — 2026-04-30

### 矛盾(N 项)
- [页面A] 与 [页面B] 在 [主题] 上矛盾...

### 过时(N 项)
- [页面] 中的 [主张] 已被 [新资料] 取代...

### 孤立页面(N 项)
- [页面] — 无入链,建议...

### 建议(N 项)
- ...

工具使用规则

更新 index.md、log.md 等累积性文件时:

  • 必须先用 Read 读取当前内容
  • 必须用 Edit 工具做增量修改(追加、替换)
  • 禁止用 Write 工具覆盖整个文件

Write 工具仅用于:

  • 创建全新文件
  • 用户明确要求覆盖整个文件

脚本执行优先级

需要执行脚本操作时,按以下顺序选择实现方式:

  1. Python — 检测到 Python 环境则优先使用
  2. Linux — Shell 脚本(bash/sh)
  3. Windows + Git Bash — 用 Git Bash 执行
  4. Windows(无 Git Bash) — PowerShell

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.