agentleFS
cookyman74cookyman74/llmwiki-harness/.claude/skills/wiki-lint/SKILL.md

wiki-lint

Skill34 starsChanged 3 months agoMITView on GitHub

How to health-check the LLM wiki (v2) — run link-audit + decay scripts, audit confidence/supersession, then drive consolidation (L2→L3→L4 promotion) and reason about contradictions, stale claims, missing pages/cross-references. Produces a prioritized fix list. Use for wiki lint/점검/health check/정리/orphan/broken link/망각/신뢰도 검사.

44 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

  • tboome33Skill

    wiki-export

    Export a vault's wiki either as a single portable file (llms.txt or llms-full.txt per the llmstxt.org standard) or as an OKF knowledge bundle (Google's Open Knowledge Format v0.1 — a shareable directory of markdown files any AI agent can consume). Use when the user says "export my wiki", "make an llms.txt", "share my wiki", "export as OKF", "make an OKF bundle", "publish my wiki as a bundle", "backup the wiki to a single file", "/wiki-export", or asks for a portable dump of their knowledge base.

    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

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

The file

Files
SKILL.md

wiki-lint (v2)

위키 건강 검진. 싼 결정적 검사 먼저, 비싼 추론·통합 나중.

1단계: 결정적 검사 (스크립트 — LLM 토큰 0)

# 페이지 포맷 검증: stray 태그·frontmatter·type·confidence 형식 (무성 오염 조기 차단)
python3 .claude/skills/wiki-lint/scripts/validate-pages.py . --json
#   → stray-tag/no-frontmatter/no-type/bad-confidence 위반 발견 시 먼저 정리
# 링크: 끊긴 wikilink + 고아 + 누락 타겟 집계 (L3/L4/moc 대상)
python3 .claude/skills/wiki-lint/scripts/link-audit.py . --json
#   broken       : 대상 없는 wikilink (page,target 중복 제거)
#   orphans      : inbound 0 페이지 (진짜 고아)
#   stub_targets : 없는 페이지를 가리키는 링크를 inbound(참조 페이지 수)순 집계
#                  → 여러 페이지가 가리키는 스텁 = 누락 개념 최우선 작성 후보 (5단계와 연결)
# 망각: Ebbinghaus 보존율, faded(R<0.3)/aging 페이지
python3 .claude/skills/wiki-lint/scripts/decay.py --scan . --json
# 본문 검색 (필요 시)
python3 .claude/skills/wiki-lint/scripts/search.py "<query>"

2단계: 망각 처리 (forgetting)

decay.py의 faded 페이지(R<0.3, status≠stale):

  • 여전히 유효하면 → 재확인: last_confirmed: 오늘으로 갱신(리셋). 새 근거 있으면 sources·confidence도.
  • 낡았으면 → 아카이브 후보로 제안(status: stale 또는 L2로 강등). 자동 삭제 절대 금지 — 사용자 승인.
  • decay_class가 잘못됐으면(중요한데 transient) 교정 제안.

3단계: 신뢰도·덮어쓰기 감사

  • 신뢰도 재계산: sources: 개수·유형으로 confidence.py 재실행, frontmatter와 불일치하면 교정.
  • supersession 정합: superseded_by↔supersedes 양방향 링크가 짝맞는지, stale 페이지가 새 페이지를 가리키는지 확인. 짝 없는 stale·끊긴 대체 링크 보고.
  • 저신뢰(confidence<0.6) 주장은 근거 보강(새 소스 인제스트) 제안.

4단계: 통합 승격 (consolidation)

wiki-consolidate 스킬 절차로:

  • L2→L3: list-claims.py로 L2 주장 수집 → 같은 주장 3회+ 등장분을 L3 fact로 승격 후보(모순 있으면 보류).
  • L3→L4: 같은 절차 2회+ 관찰분을 L4 procedure로 추출 후보. 승격은 후보로 제안, 승인 후 반영.

5단계: 추론 검사 (스크립트가 못 잡는 것)

  • 모순. 페이지 간 상충 → 삭제 말고 병기(supersession 아니면 > [!warning] 상충).
  • 낡은 주장. 새 소스가 뒤집었는데 stale 미표기 → supersession 처리 제안.
  • 누락 개념. link-audit의 stub_targets에서 inbound 많은 스텁(여러 페이지가 가리킴) → 생성 최우선 후보. 본문에서 언급만 되고 링크도 없는 개념도 찾는다.
  • 빠진 교차참조/관계. 관련 페이지쌍의 [[ ]]·## 관계 누락.
  • 데이터 공백. 웹 검색·새 소스로 메울 구멍 → 인제스트 후보.

6단계: 보고

심각도 정렬 수리 목록:

  1. 끊긴 링크·모순·짝 없는 supersession (정확성)
  2. faded 페이지·낡은 주장·고아 (신뢰성/발견성)
  3. 승격 후보·누락 개념·빠진 관계 (완결성/성장)

조사할 새 질문·찾을 새 소스도 제안. 수리 반영 시 updated·해당되면 last_confirmed 갱신, log에 ## [오늘] lint | <요지> append(자동화 훅이 이 항목으로 경과일 계산 — 반드시 남긴다).

7단계: 후속 액션 (P3 — 지적이 실행으로)

lint이 반복 지적만 하고 아무도 안 고치는 것을 막는다:

  • 고inbound 스텁 자동초안 제안. stub_targets 중 inbound ≥3(여러 페이지가 가리킴)은 작성 가치가 확실 → 사용자에게 "이 스텁들 초안 만들까?" 제안하고, 승인 시 wiki-ingestor(또는 직접)로 골격 페이지 생성. (예: bert·gpt·llm·rnn — 3회 연속 lint에서 방치됐던 것)
  • 미해결 항목 → 확인 큐. 사람 판단이 필요한 것(동일성 미확인 예: firstpick↔recruitment, 상충 우열 불명)은 lint가 임의 판정하지 말고 _workspace/needs-confirm.md에 - [ ] <항목> (근거·필요한 확인)으로 적재. SessionStart가 리마인드하고, 해소되면 체크. (표류 방지)

원칙

제안 먼저, 자동 수정 금지. 삭제·병합·강등·대규모 재작성은 승인 후. 안전 수정(짝 링크 추가, 신뢰도 숫자 교정, last_confirmed 리셋)만 승인받아 적용. 스크립트가 링크·망각·신뢰도를 공짜로 계산하니, LLM 예산은 의미 검사(모순·승격 동치 판단)에 쓴다.

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.