Vault-optimalizáló

Mire jó

A tudásbázis nem attól romlik el, hogy keveset írsz bele, hanem attól, hogy sokat. Két év jegyzet után lesz benne hatvan link, ami sehova nem mutat, három helyen leírt cégbemutatkozás, és egy 800 soros CLAUDE.md, amit senki nem mert megvágni.

A számla ezután érkezik. Egy 200 sornál hosszabb CLAUDE.md-t a Claude egyre lazábban követ, a duplikált kontextusból pedig kiszámíthatatlan, melyik változatot veszi elő.

Ez a skill azért készült, hogy ne kelljen hozzá kötött szerkezet. Feltérképezi, mi van a mappádban, és terhelés szerint rangsorol. A gyökér CLAUDE.md-re más szabályok vonatkoznak, mint egy napi jegyzetre, és mindig a helyénvalót alkalmazza.

A végén 0–100 pontszámot kapsz, kategóriánként eldöntöd, mit javítson, és egy HTML-műszerfalat, ami az előtte-utána állapotot is mutatja.

Kinek hasznos

• Egyfős szolgáltatónak, akinek a jegyzettára egy-két év alatt átláthatatlanná nőtt, és nagytakarítást akar, nem újraalapozást
• Annak, aki saját logika szerint építette a tudásbázisát, és mégis szeretné átvizsgáltatni
• Tanácsadónak, aki több száz markdown-jegyzetet halmozott fel, és nem tudja, melyikre nem hivatkozik már semmi
• Annak, aki azt tapasztalja, hogy a Claude lassabban válaszol ugyanabban a mappában, mint fél éve

Kinek nem való

• Ha a vaultod a Második agy alapozó szerkezetét követi, és rendszeres karbantartást akarsz, a Vault-átvilágítót válaszd. Ugyanaz a 22 ellenőrzés fut, de az dátumozott markdown-riportot ír, amit hónapról hónapra összevethetsz. Ez a skill egyszeri nagytakarításra való, HTML-műszerfallal
• Húsz jegyzetnél nincs mit optimalizálni: a feltérképezés lefut, de a találati lista üres marad
• Notion-oldalakon vagy adatbázisban tárolt jegyzeteken nem működik, mert markdown-fájlokon dolgozik
• A böngészős felületről nem futtatható, mert a gépeden lévő fájlokat olvassa és írja

Mit csinál lépésről lépésre

1. Könnyű ellenőrzést végez, hogy a mappa tudásbázisnak néz-e ki. Kötött szerkezetet nem vár el, elég, ha van benne markdown-fájl vagy CLAUDE.md.
2. Feltérképezés: végigjárja az összes markdown-fájlt, és tizenkét szerep egyikébe sorolja. Külön kategória a gyökér és a mappa-szintű CLAUDE.md, az index, a skill, a napi jegyzet, a meeting, a döntés és a kontextus.
3. Gazdátlan mappákat keres: ahol öt markdown-fájlnál több van, de nincs se CLAUDE.md, se index, se README, ott nincs, ami eligazítsa a Claude-ot.
4. Terhelés szerint rangsorol: először a gyökér CLAUDE.md, aztán a mappa-szintűek, az indexek, végül a jegyzetek.
5. Lefuttatja a 22 ellenőrzést négy csoportban: méret és token, wiki-lint (halott linkek, árva jegyzetek, duplikátumok, csonka fájlok), skill-szerkezet és általános higiénia.
6. Összefoglalót ad 0–100 pontszámmal, és minden találathoz megmutatja, melyik szabályon bukott el.
7. Kategóriánként megkérdezi, mit javítson: mindent, csoportonként válogatva, vagy csak a riportot kérheted.
8. Elvégzi a jóváhagyott javításokat, HTML-műszerfalat renderel, elmenti a döntés-mappába, és a chatben is megmutatja.

Mit tartalmaz a csomag

• SKILL.md: a feltérképezés-először folyamat, a fájlszerepek felismerési szabályai és a pontozási képlet
• references/passes-size-tokens.md: a méret-küszöbök, például a 200 soros CLAUDE.md-határ és a fájlonkénti 10 KB-os figyelmeztetés
• references/passes-wiki-lint.md: a halott linkek, árva jegyzetek, duplikátumok és csonka fájlok felismerése
• references/passes-skills.md és passes-vault-hygiene.md: skill-szerkezeti és higiéniai ellenőrzések a fejléc-adatoktól a fájlnevekig
• Hét módszertani háttér-fájl, hogy minden találatnál visszakereshesd, milyen szabályon alapul, plusz két HTML-sablon a műszerfalhoz

Hogyan használd

Akkor vedd elő, amikor a tudásbázisod már fáj: nem találsz benne, a Claude lassabban válaszol, vagy elavult adatokkal dolgozik. Nyisd meg a vault gyökérmappáját, és kérd meg, hogy világítsa át és optimalizálja.

Az első futás előtt csinálj biztonsági másolatot, így minden javítás visszavonható marad.

Az összefoglalónál ne engedd rá mindenre elsőre. Kezdd a méret- és a halott link kategóriákkal, ezek a legkevésbé kockázatosak. A duplikátum-összevonással várj, amíg megnézted, mit tartana meg és mit dobna el. Ha nagy volt a takarítás, futtasd le még egyszer: a második pontszám mutatja meg, mennyit ért a rendrakás. A CLAUDE.md optimalizálásáról szóló lecke ide kattintva érhető el.

Jó tudni

A vault gyökérmappájából kell futtatni. Nem kell hozzá API-kulcs, fiók vagy külső szolgáltatás, viszont Claude Code kell. Magától semmit nem ír át, minden javítás kategóriánkénti jóváhagyáshoz kötött.

A legsúlyosabb találatokat szándékosan nem javítja ki. A túl hosszú CLAUDE.md és a túlhízott fájlok átírása emberi döntés: ott jelez, de a szöveget rád hagyja.

A pontszám nem jegy, hanem irány. 90 fölött havonta elég futtatni, 70 alatt a terjengősség már látszik a válaszok minőségén, 50 alatt a szerkezet újragondolása kerülhet szóba, nem a foltozás.

A belső utasításai angol nyelvűek, de magyarul is dolgozhatsz vele.

Telepítés

1. Töltsd le a csomagot a fenti gombbal.
2. claude.ai vagy Claude Desktop: Beállítások → Képességek (Capabilities) → Skillek → töltsd fel a letöltött zipet.
3. Claude Code: csomagold ki a zipet a projekted .claude/skills/ mappájába (vagy globálisan a ~/.claude/skills/ alá).
4. Ezután írd le a feladatot a saját szavaiddal — a skill automatikusan aktiválódik. Ha biztosra mennél, hivatkozz rá névvel.