Vault-átvilágító

Mire jó

A tudásbázis romlása nem egyszerre történik, hanem hetente egy kicsit. Átnevezel egy jegyzetet, és tíz link elszakad. Kétszer leírod ugyanazt a cégbemutatkozást. A CLAUDE.md 120 sorról 260-ra hízik, mert mindig csak egy sort tettél hozzá.

Egyik sem tűnik fel, amíg a Claude nem kezd téveszteni. Onnantól viszont nem tudod, mi a baj: a prompt rossz, vagy a kontextus. A legtöbben ilyenkor a promptot javítgatják, pedig a hiba a háttéranyagban van.

Ez a skill azért készült, hogy legyen mérőszámod. Lefuttat 22 ellenőrzést négy csoportban, 0–100 pontot ad az állapotra, kategóriánként megkérdezi, mit javítson, majd dátumozott riportot ment a döntések mappájába. A következő futásnál a két riport egymás mellé tehető.

Ez a rutinszerű karbantartás eszköze. Növekvő vaultnál heti egy, stabil rendszernél havi egy futás.

Kinek hasznos

• Egyfős szolgáltatónak, aki a Második agy alapozóval építette a vaultját, és havi rutinná tenné a karbantartást
• Tanácsadónak, aki gyanítja, hogy a téves válaszok mögött elavult vagy duplikált cégkontextus áll
• 2–10 fős irodának, ahol többen írnak a közös vaultba, és kell egy visszatérő ellenőrzés
• Annak, aki dokumentálva akarja látni a tudásbázisa állapotát, nem csak érezni, hogy „rendben van”

Kinek nem való

• Kötetlen szerkezetű tudásbázison nem indul el, mert a gyökérben CLAUDE.md-t és Context mappát vár. Erre a Vault-optimalizáló készült, amely előbb feltérképezi és szerep szerint besorolja a fájlokat, majd HTML-műszerfallal zár. Ugyanaz a 22 ellenőrzés, más belépő és más kimenet
• Egyszeri nagytakarításhoz ez a skill nem ideális. Az ereje az ismétlésben és az összehasonlítható riportokban van
• Két hét használat után még nincs mit átvilágítani
• Böngészőben nem működik: a vault gyökérmappájából futtatva, helyi fájlokon dolgozik

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

1. Ellenőrzi, hogy a vault gyökeréből fut-e. Ha nincs CLAUDE.md és Context mappa, leáll.
2. Csendben lefuttatja a 22 ellenőrzést négy csoportban. Nem narrálja a munkát, egyben hozza a találatokat.
3. Méret és token: a 200 sornál hosszabb CLAUDE.md fájlok, a 10 KB feletti jegyzetek, és a fájlok, amelyekben a lényeg túl hátra került.
4. Wiki-lint: halott linkek, árva jegyzetek (amikre semmi nem hivatkozik), azonos szerepű duplikátumok, útválasztási hibák és csonka fájlok.
5. Skillek és higiénia: a saját skilljeid szerkezete, a fejléc-adatok, a fájlnevek egyértelműsége, a hiányzó indexek és a kettős főcímek.
6. Markdown-összefoglalót ír 0–100 pontszámmal, és minden találathoz megnevezi a szabályt, amin elbukott.
7. Kategóriánként megkérdezi, mit javítson, és csak a jóváhagyottakat végzi el.
8. Dátumozott riportot ment a döntések mappájába, a pontszám előtte-utána értékével együtt.

Mit tartalmaz a csomag

• SKILL.md: a belépő ellenőrzés, a négy csoport futtatási sorrendje, a pontozási képlet és a riport szerkezete
• references/passes-size-tokens.md: a méret-küszöbök, például a 200 soros CLAUDE.md-határ, a 10 KB-os figyelmeztetés és a 100 KB-os felső korlát
• references/passes-wiki-lint.md: a halott linkek, árva jegyzetek, duplikátumok, útválasztási hibák és csonka fájlok felismerése, kihagyási listákkal
• references/passes-skills.md és passes-vault-hygiene.md: a skill-fájlok szerkezeti ellenőrzései, plusz nyolc higiéniai ellenőrzés a kötelező mezőktől a fájlnév-minőségig
• Hét módszertani háttér-fájl, hogy minden szabály visszavezethető legyen a forrására

Hogyan használd

Tedd naptárba. Ez a skill akkor ér valamit, ha nem akkor futtatod, amikor már baj van, hanem rendszeresen. Növekvő vaultnál hetente, stabil rendszernél havonta.

Futtatás előtt lépj be a vault gyökérmappájába, és kérd meg, hogy világítsa át a vaultot. Nem kell megmondanod, mit keressen, mind a 22 ellenőrzés lefut.

Az első futásnál sok találatot fogsz kapni, ez normális. Kezdd a halott linkekkel és a fejléc-hibákkal, ezek gépiesen javíthatók. A duplikátumokat és a túl hosszú CLAUDE.md-t hagyd a végére, ott döntés kell.

A második futástól a riportok a lényegesek. Tedd egymás mellé a legutóbbi kettőt: ha a pontszám nem mozdul, nem a takarítással van baj, hanem a szokásaiddal. A kontextus-mappák és a CLAUDE.md szerepéről szóló leckét itt olvashatod el.

Jó tudni

Előfeltétel egy már felépített, kötött szerkezetű vault. A gyökérben CLAUDE.md-t és Context mappát vár, ezek hiányában nem indul el.

Magától semmit nem ír át. Minden javítás kategóriánkénti jóváhagyáshoz kötött, és a legsúlyosabb tételek (túl hosszú CLAUDE.md, túlhízott fájlok) szándékosan kézi átírásra várnak.

A pontszám sávos: 90 fölött jól hangolt a rendszer, 70 és 89 között látható az elcsúszás, 50 és 69 között a terjengősség már rontja a válaszok minőségét, 50 alatt a szerkezet újragondolása kerül napirendre.

Nem kell hozzá fiók, kulcs vagy külső szolgáltatás, viszont Claude Code kell. 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.