agentleFS
hootbuhootbu/llm-wiki-mind/skills/vault-lint/SKILL.md

vault-lint

Skill1 starsChanged 7 months agoMITView on GitHub

llm-wiki-mind vault'unun sağlık kontrolü. Sayfalar arası çelişkileri, stale claim'leri, orphan sayfaları, broken link'leri, tek-yönlü referansları ve veri boşluklarını tespit eder; rapor üretir; otomatik düzeltilebilenleri kullanıcı onayıyla uygular; araştırmaya değer yeni sorular önerir. Vault büyürken sağlıklı kalması için periyodik çalıştırılır.

5 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions5 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 5

    1. Howie126313/obsidian-vault-kit★ 3same name
    2. jamejialicona-cmyk/vault-starter★ 2same name
    3. tograf/sidebrain★ 1same name
    4. Lucioway/way-stack★ 0same name
    5. slogsdon/skills-vault-knowledge★ 0same name

    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 repository3 other files it gives its agents.

The file

Files
SKILL.md

vault-lint — vault sağlık kontrolü

Tetiklendiğinde yapılacaklar — vault'un CLAUDE.md §8'deki LINT workflow'unu uygular.

1. Vault'u bul

  • pwd veya yakın bir CLAUDE.md işaretçisinden VAULT_PATH'i çıkar.
  • Vault geçerli mi kontrol et: CLAUDE.md, index.md, log.md mevcut olmalı.

2. Yedi kontrol

(1) Çelişki taraması

Tüm sayfalarda ⚠ Çelişki notlarını ara. Her biri için:

  • İki kaynağı listele.
  • Mümkünse yeni bir raw ingest ile çözüm önerisi sun.
  • Çözülmüşse ⚠ satırını kaldırıp normal bölüm olarak yaz (kullanıcı onayıyla).

(2) Stale claim

updated: alanı 90 günden eski + status: active sayfaları listele. İlgili raw kaynaklar değişti mi kontrol et (örn. kod tabanı dosyaları). Öneri: re-ingest veya status: stale işaretle.

(3) Orphan sayfalar

Hiçbir sayfadan link almayan sayfaları bul:

# pseudo: her sayfa için, başka sayfalarda [[slug]] geçiyor mu?

Öneri: link ekle (uygun yerde) veya archive/ altına taşı.

(4) Broken link

[[linklenmiş]] ama dosyası olmayan sayfaları bul. Her biri için:

  • Stub oluştur (frontmatter + bir cümle "henüz ingest edilmedi" notu), veya
  • Link'i kaldır (kullanıcı onayıyla).

(5) Tek-yönlü referans

A sayfası B'ye link verirken B'de A geçmiyorsa, B'nin ## İlgili bölümüne [[A]] ekle.

(6) Veri boşlukları

"henüz ingest edilmedi", "burada açıklanacak", "(doldurulacak)" gibi placeholder'lar. Web araması veya raw ekleme önerisi.

(7) Yeni soru önerileri

Wiki'deki kalıplara bakarak araştırmaya değer 3-5 yeni soru çıkar. Örn:

  • "Aggregated Price Architecture'ın pratik etkisi nasıl ölçüldü?"
  • "Adapty'den RevenueCat'a geçişin maliyet sonuçları ne oldu?"

3. Rapor

Tek bir markdown rapor olarak döndür:

# Wiki Lint Raporu — YYYY-MM-DD

## Özet
- N çelişki
- M stale sayfa
- K orphan sayfa
- J broken link
- X tek-yönlü referans
- Y veri boşluğu

## Detay
<her kategori için liste + öneri>

## Otomatik düzeltilebilir
- [ ] <kullanıcı onayıyla uygulanacak değişiklik>
- [ ] ...

## Araştırmaya değer yeni sorular
1. ...
2. ...

4. Uygulama

Kullanıcı otomatik düzeltmeleri onaylarsa tek tek uygula (her dosya için diff göster, yazmadan önce).

5. Log

## [YYYY-MM-DD] lint | N çelişki, M stale, K orphan, J broken → X düzeltildi

Hatırlatıcılar

  • Sayfa silme yasak — archive'a taşı.
  • Çelişki çözülmeden silinmez — kaynak belirsizse status: draft yap, ⚠ notunu tut.
  • Büyük vault'larda (>500 sayfa) kategori kategori ilerle; kullanıcıyı bunaltma.

Kullanım örnekleri

  • "Wiki sağlık kontrolü yap."
  • "Son bir ayda yazdığım sayfalar arasında çelişki var mı?"
  • "Orphan sayfaları listele ve ne yapacağımızı öner."

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.