# Claude Code Skills 2026-ban: hogyan építs saját Skills-könyvtárat > Hogyan készíts Claude Code Skills-fájlokat: a SKILL.md szerkezete, a description képlete, hivatalos Anthropic-gyűjtemények, valamint kerülendő minták. Lépésről lépésre 30 perc alatt. Source: https://ailoot.ai/blog/hu/claude-code-skills-library/ Canonical: https://ailoot.ai/blog/hu/claude-code-skills-library/ Language: hu Publisher: Ailoot (https://ailoot.ai/) Translation: guide-213 Revision: sha256-e3755a7059bf6c2c436bcac9a261e0cae8d11bccc945cf80ac7c71f2feb1a862
Főbb pontok A Claude Code Skills olyan mappák, amelyek SKILL.md fájlt tartalmaznak; Claude csak akkor tölti be őket a kontextusba, amikor szükség van rájuk. A CLAUDE.md folyamatosan a memóriában marad, és fogyasztja a tokenkeretet, míg egy skill aktiváláskor töltődik be—és egyetlen projektben könnyen megfér egymás mellett több tucat skill. A skill legfontosabb része a description: Claude ennek alapján dönti el, hogy aktiválja-e a skillt. Ebben a cikkben bemutatom a SKILL.md szerkezetét, a description képletét, a kész gyűjteményeket, és azt, hogyan készítheted el az első skilledet 30 perc alatt.
[Ailoot dokumentáció: API, kulcsok és beállítás](https://ailoot.ai/docs/). ## Mi az a skill a Claude Code-ban, és miért nem csupán „egy nagyobb prompt”?
Főbb pontok A skill olyan könyvtár, amely SKILL.md fájlt tartalmaz, és leírja, mikor, illetve hogyan kell alkalmazni egy adott módszertant. Az Anthropic egy új alkalmazottnak szóló útmutatóhoz hasonlítja: nem diktálsz neki minden nap minden lépést; átadsz neki egy eljárást, és ő maga alkalmazza a megfelelő helyzetekben. A CLAUDE.md-től az a fő különbség, hogy a skill csak szükség esetén töltődik be a kontextusba, így több tucat skill lehet egy projektben anélkül, hogy elfogyna a tokenkeret.
A Claude Code Skills a Claude Code beépített funkciója, amelyet az Anthropic 2025 októberében indított el a Pro/Max/Team/Enterprise csomagokhoz. Később nyílt szabvánnyá tette az [Agent Skills](https://agentskills.io) specifikációt, amely Claude-on kívül is működik. Kódként mindössze egy mappa: ``` .claude/skills/ ├── deploy-to-prod/ │ ├── SKILL.md │ └── scripts/ │ └── check-migrations.sh ├── weekly-content-plan/ │ └── SKILL.md └── triage-support-tickets/ └── SKILL.md ``` Minden mappa egy skill. A `SKILL.md` egy Markdown-fájl YAML frontmatterrel a tetején, alatta pedig hétköznapi utasításokkal. Amikor a felhasználó azt kéri, hogy „telepítsük éles környezetbe”, Claude meglátja a `deploy-to-prod` skill leírását, felismeri a „telepítés éles környezetbe” aktiválási kifejezést, betölti a SKILL.md törzsét a kontextusba, és követi a lépéseket. ### A fokozatos betöltés három szintje Az Anthropic fokozatos betöltéssel építette meg a skillrendszert: az adatok szükség szerint, rétegekben töltődnek be. Az Anthropic Engineering blogban a csapat ezt az „alapelvként” írja le, „amely rugalmassá és skálázhatóvá teszi az Agent Skills rendszert” ([Anthropic Engineering](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills)). A betöltés három szintje: 1. **Metaadat (mindig)** - a munkamenet kezdetekor Claude csak az egyes skillek `name` és `description` mezőjét látja. Keret: skillenként körülbelül 100 token. 2. **Utasítások (aktiváláskor)** - ha a felhasználó valami relevánsat mond, Claude betölti a SKILL.md törzsét. Keret: kevesebb mint 5000 token. 3. **Erőforrások (kérésre)** - a csomagolt fájlok (példák, sablonok, adatkészletek) csak akkor töltődnek be, amikor maga a modell keresi őket. Keret: korlátlan. Korábban a [CLAUDE.md](https://ailoot.ai/blog/hu/claude-md-template/) fájlban kellett tartani mindent, amire az AI-nak „emlékeznie” kellett—egy 50 szabályt tartalmazó projekt pedig gyorsan elérte a kontextuskorlátot. A skillekkel egy projekten belül könnyen megfér több tucat, mert a kezdeti kontextusba csak a leírásuk kerül be. ### Hol találhatók a skillek: négy szint | Szint | Elérési út | Hatókör | |------------|-----------------------------------|--------------------| | Enterprise | Felügyelt szervezeti beállítások | A vállalat összes felhasználója | | Personal | `~/.claude/skills//SKILL.md` | Az összes projekted | | Project | `.claude/skills//SKILL.md` | Csak ez a projekt | | Plugin | `/skills//SKILL.md` | Ahol a plugin engedélyezve van | A prioritás sorrendje: az enterprise felülírja a personal, a personal pedig a project beállítást. A pluginek a `plugin-name:skill-name` névteret használják, és nem ütköznek. Kényelmes megoldás: az általános szakmai skilleket tedd a `~/.claude/skills/` mappába, a projektspecifikusakat pedig a tároló `.claude/skills/` mappájába. ## Mi található egy SKILL.md fájlban?
Főbb pontok A SKILL.md egy Markdown-fájl YAML frontmatterrel a tetején, alatta pedig utasításszöveggel. Legalább két mezőből áll: name (legfeljebb 64 karakter) és description (legfeljebb 1024 karakter). A teljes séma tartalmazza az allowed-tools, disable-model-invocation, paths, context: fork, agent és hooks mezőket is. Az Anthropic azt javasolja, hogy az utasítástörzs maradjon 500 soron belül, minden mást pedig a közeli referenciafájlokban helyezz el.
Íme egy minimális példa—húsz sor, és a skill készen is áll: ```markdown --- name: weekly-content-plan description: Heti bejegyzéstervet készít egy Telegram-csatornához és rövid videókhoz. Aktiválási kifejezések - "készíts bejegyzéstervet", "mit tegyek közzé ezen a héten", "7 napos csatornaterv". Ne aktiváld, ha a kérés weboldalról vagy e-mailes hírlevélről szól. --- # Heti bejegyzésterv ## Lépések 1. Olvasd el a `knowledge/audience.md` fájlt - kinek írunk 2. Olvasd el a `knowledge/tone-of-voice.md` fájlt - hogyan írunk 3. Olvasd el a csatorna utolsó 10 bejegyzését - mi szerepelt már 4. Találj ki 7 témát a hétre: 3 értékesítésközpontú, 2 szakértői, 2 személyes 5. Mindegyikhez adj meg egy figyelemfelkeltő sort és három felsoroláspontot a bejegyzésről 6. Táblázatként add meg: a hét napja | típus | figyelemfelkeltő sor | terv ``` Ennyi elég. Ha a felhasználó azt írja, hogy „tervezzük meg a heti bejegyzéseket”, Claude meglátja a descriptionben az aktiválási kifejezést, betölti a SKILL.md fájlt, elolvassa a megnevezett fájlokat, majd táblázatot készít. ### Érdemes észben tartani a korlátokat A [hivatalos Claude API-dokumentáció](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) szigorú korlátokat szab: - **`name`**: legfeljebb 64 karakter, csak kisbetűk, számok és kötőjelek, XML-címkék nélkül. Az `anthropic` és a `claude` foglalt. - **`description`**: az API-ban legfeljebb 1024 karakter; kötelező, XML-címkék nélkül. - **Listázási keret**: a Claude Code-ban az összes skill description mezője együtt a kontextusablak körülbelül 1%-át használja fel. Ha sok skill van, a description mezők csonkolódnak—és eltűnhetnek a kulcsszavak, amelyek alapján Claude felismeri a kérést. - **A SKILL.md törzse**: az Anthropic azt javasolja, hogy legfeljebb 500 soros legyen. A hosszabb részeket tedd a `references/`, `scripts/` és `examples/` mappák fájljaiba, majd az utasításokból hivatkozz rájuk. A kontextus tömörítése (`/compact`) után Claude megtartja minden korábban meghívott skill első 5000 tokenjét; az összes visszacsatolt skill együttes kerete 25 000 token. Ha egy skill nem fér bele, a viselkedése „feledésbe merül.” ### A frontmatter teljes sémája Legalább a `name` és a `description` mezőt használd. Az éles skillek más mezőket is használnak: | Mező | Cél | Példa | |----|----|----| | `name` | A skill neve; ha nincs megadva, alapértelmezés szerint a mappa neve | `deploy-to-prod` | | `description` | Az automatikus meghívás aktiválási feltétele | Lásd az alábbi képletet | | `when_to_use` | További aktiválási kifejezések | `["deploy", "let's ship it"]` | | `allowed-tools` | Az engedélykérés nélkül használható eszközök | `["Read", "Bash(npm run build)"]` | | `disable-model-invocation` | `true` - csak a felhasználó hívhatja meg | Veszélyes műveletekhez | | `user-invocable` | `false` - csak Claude hívhatja meg | Háttértudáshoz | | `paths` | Globminták, amelyeknél a skill aktív | `["src/**/*.ts"]` | | `context: fork` | Futtatás elkülönített alügynökben | Ha nagy a kontextus | | `agent` | Az elindítandó alügynök típusa | `Explore`, `Plan`, `general-purpose` | | `effort` | Gondolkodási szint | `low`, `medium`, `high`, `xhigh`, `max` | | `model` | A skillhez rendelt modell | `claude-opus-4-7` | | `hooks` | Hookok a skill életciklusában | Lásd a hooks szakaszt | A `disable-model-invocation: true` mező kötelező minden olyasmihez, aminek nem szabad automatikusan lefutnia. Például ezzel a jelzővel a `deploy-to-prod` skill csak akkor hívható meg, ha a felhasználó kifejezetten beírja a `/deploy-to-prod` parancsot. A jelző nélkül Claude azért is elindíthatja a telepítést, mert „a kód késznek tűnik.” ## Miért a description jelenti a munka 90%-át, és hogyan írj jót?
Főbb pontok A description az egyetlen mező, amelyet Claude a munkamenet elején lát. Ha rosszul van megírva, a skill nem fog működni akkor sem, ha az utasítástörzs tökéletes. A jó description három részből áll: mit csinál + idézőjelbe tett aktiválási kifejezések + mikor NE használd. Az Anthropic saját `skill-creator` skillje azt javasolja, hogy a description legyen „kissé rámenős”—Claude hajlamos túl ritkán aktiválni a skilleket.
A vibe-coderek leggyakoribb hibája, hogy ilyen descriptiont írnak: „Segéd X-hez.” A skill ott van a mappában, de Claude nem hívja meg. ### Rossz description ```yaml description: Build dashboards. ``` Claude nem tudja megállapítani: ha a felhasználó azt kéri, hogy „mutasd meg a heti értékesítést”, az vajon dashboardot jelent-e? Ha „bevételi grafikont” kér, az dashboardot jelent vagy csak egy általános grafikont? Ha „havi jelentést” kér, az biztosan nem dashboard? Az Anthropic saját [`skill-creator`](https://github.com/anthropics/skills/blob/main/skills/skill-creator/SKILL.md) útmutatója egyenesen megfogalmazza az ajánlást:

Claude jelenleg hajlamos arra, hogy a skilleket „alulaktiválja”—nem használja őket akkor, amikor hasznosak lennének. Ennek ellensúlyozására tedd a skill description mezőjét kissé „rámenőssé”.

— Anthropic Skill Creator (SKILL.md), https://github.com/anthropics/skills/blob/main/skills/skill-creator/SKILL.md
### A jó description képlete Három rész: 1. **Mit csinál** - egy mondat az eredményről, nem a folyamatról. Ne azt írd, hogy „SQL-t generál”, hanem azt, hogy „Telegram-csatorna számára táblázatba exportálja az értékesítési adatokat.” 2. **Mikor aktiválódjon** - 3-5 idézőjelbe tett kifejezés, amelyet a felhasználók valóban mondanak. Ne találgass; nézd meg a csevegési és támogatási előzményeket. 3. **Mikor NE aktiválódjon** - 1-2 kifejezés olyan hasonló feladatokról, amelyekre a skillnek nem szabad reagálnia. Enélkül két hasonló skill folyamatosan ütközik. Íme egy erős description a projektemből (egyszerűsítve és anonimizálva): ```yaml description: | SEO-útmutatót ír és tesz közzé a blogon a szerkesztési irányelvek szerint. Aktiválási kifejezések: "írj útmutatót X-ről", "készítsünk új pilléroldalt", "Y-ról szóló blogcikk", "készíts blogútmutatót Z-ről". Ne aktiváld, ha a kérés e-mailes hírlevélről, Telegram-bejegyzésről vagy belső csapatutasításról szól— ezek más skillek. ``` Ami itt jól működik: - A „ír és közzétesz” ige a „segít” helyett konkrét eredményt jelöl. - Négy idézőjeles aktiválási kifejezés fedi le a különböző megfogalmazásokat. - Angol aktiválási kifejezés is szerepel benne—ha a felhasználó a csapat nyelvére vált, a skill akkor is működik. - A külön „ne aktiváld, ha” rész megakadályozza az ütközést az e-mailes és bejegyzéses skillekkel. ### Hogyan teszteld a descriptiont? A `skill-creator` részeként az Anthropic beépített egy trigger-evals módszertant: 20 prompttal ellenőrizheted, aktiválódik-e a skill. Tíz promptnak aktiválnia kell, tíznek nem (köztük olyan közeli eseteknek, ahol a megfogalmazás hasonló, de a feladat más). Vibe-coder-nyelven ez azt jelenti: a description megírása után nyiss egy üres csevegést, és próbálj ki 5 olyan kifejezést, amelyet ténylegesen használsz, plusz 3 hasonlót, amely mást jelent. Ha a skill nem aktiválódik, amikor kellene, vagy akkor aktiválódik, amikor nem kellene, módosítsd a descriptiont. Csak ezután írd meg az utasítástörzset. ## Melyik 5 skillt telepíteném először?
Főbb pontok A vállalkozók számára a leggyorsabb stratégia, ha kész gyűjteményekkel kezdenek, majd testre szabják őket. Az Anthropic és a Vercel nyilvános gyűjteményeket tett közzé, amelyek egyetlen paranccsal telepíthetők, és tipikus feladatokat fednek le, például a dokumentumkészítést és a tervezést. 2026 májusában a hivatalos `anthropics/skills` tárolónak körülbelül 138 000 csillagja volt.
Az első két hetet saját skillek írásával tölteni rossz stratégia. Először telepíts kész skilleket, és nézd meg, hogyan épülnek fel; utána ugyanilyen módon add hozzá a sajátjaidat. Olcsóbb mások bevált gyűjteményeit átvenni és magadra szabni, mint mindent a nulláról felépíteni. Íme az az öt gyűjtemény, amellyel kezdenék: ### 1. anthropics/skills - Hivatalos gyűjtemény skill-creatorral Tároló: [github.com/anthropics/skills](https://github.com/anthropics/skills). 138,000 GitHub-csillag. Az Anthropic csapatának hivatalos skilljeit tartalmazza: `skill-creator` (meta-skill, amely más skilleket ír), `claude-api` (API-integrációk építésében segít), valamint kész dokumentumkezelő skillek PowerPointhoz, Excelhez, Wordhöz és PDF-hez. Telepítés Claude Code-dal: ```bash /plugin marketplace add anthropics/skills /plugin install document-skills@anthropic-agent-skills /plugin install example-skills@anthropic-agent-skills ``` A legfőbb értéke a `skill-creator`. A description alapján SKILL.md-t ír, majd 20 trigger-eval tesztet futtat, és addig módosítja a descriptiont, amíg a skill megfelelő helyzetekben nem kezd aktiválódni. Lényegében „skill skillek létrehozásához.” ### 2. mattpocock/skills - A TypeScript-szakértő virálissá vált gyűjteménye 12 aktív skillt tartalmaz, többek között: Telepítés: ```bash npx skills@latest add mattpocock/skills /setup-matt-pocock-skills ``` ### 3. coreyhaines31/marketingskills - Gyűjtemény marketingeseknek Ha online programokat vezetsz, szabadúszó marketingesként dolgozol vagy ügynökséget működtetsz, nem kell hat hónapot a saját skillek megírására szánnod. A feladatok fele már készen van. ### 4. vercel-labs/agent-skills - AI-hatás nélküli tervezés Tároló: [github.com/vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills). A vezető skillje a `web-design-guidelines`, amely több mint 100 akadálymentességi, teljesítménybeli és használhatósági szabály alapján auditálja a felhasználói felület kódját. Mellette ott van az [Anthropic frontend-design](https://github.com/anthropics/skills/tree/main/skills/frontend-design) skillje, több mint heti 110,000 telepítéssel. Arra készteti az AI-t, hogy még a kódírás előtt válasszon stílust. Nélküle minden Claude által létrehozott oldal Inter betűtípust, lila színátmenetet és rácsos kártyákat kap. Az eredmény mindenkinél ugyanaz. ### 5. obra/superpowers - Többügynökös munkafolyamat Összességében, ha telepíted az első három gyűjteményt a listából—`anthropics/skills`, `mattpocock/skills` és `coreyhaines31/marketingskills`—, akkor a Claude Code-od az első hónapban több tucat, a vállalkozói feladatok többségét lefedő kész skilllel fog rendelkezni. Nemcsak kész skilleket szeretnél telepíteni, hanem **olyan beállítást is kialakítani, amely Claude-ot valódi asszisztenseddé teszi**? A skillek ennek a módszertannak az egyik pillérét jelentik. A működő beállítás három részből áll: **AI-clone** (a Skills csomagolt szakértelemként) + **[Second Brain](https://ailoot.ai/blog/hu/claude-code-second-brain/)** (kontextust adó tudásstruktúra) + **Context Engineering** (ahogyan Claude a projekt egészét látja). Ez a beállítás találgató asszisztensből olyan eszközzé alakítja Claude-ot, amely a te logikád szerint gondolkodik. ## Milyen ismétlődő feladatokat alakíts skillé?
Főbb pontok A szabály egyszerű: bármilyen művelet jelölt egy skillhez, amelyet hetente kétszer többször végzel el, nagyjából ugyanazokat a lépéseket követve. Nem egy összetett „évente egyszer készülő jelentés a könyvvizsgálónak”, hanem rutinfeladat: csatornatartalom-terv, ügyfélbizonylatok ellenőrzése, üdvözlő e-mail egy új résztvevőnek. A skill az egyszeri erőfeszítést olyan eszközzé alakítja, amely nélküled is működik.
Ügyfélmunkákban és mások projektjeiben tucatjával láttam ezt a mintát. Valakinek van „az a feladata, amit minden alkalommal a nulláról csinál meg.” Minden hétfőn ugyanolyan típusú jelentést ír. Valahányszor új ügyfél érkezik, ugyanazt az eljárást követi. Minden publikáció ugyanazt a sablont követi. Mindez minden alkalommal 30-90 percet vesz igénybe, mert fel kell idézni a lépéseket, meg kell nyitni a megfelelő fájlokat, és újra meg kell fogalmazni a Claude-promptot. A megoldás az, hogy egyszer skillbe csomagolod a folyamatot. Ezután elég egyetlen kifejezést mondanod, Claude pedig betölti a módszertant, elolvassa a szükséges forrásokat, és elkészíti az eredményt. Három példa különböző területekről: ### 1. példa. Szabadúszó marketinges - `weekly-content-plan` skill Amit kézzel csinál: minden hétfőn három ügyfélnek készíti elő a heti Telegram-bejegyzéseket. Megnyitja az ügyfél márkahang-útmutatóját, áttekinti a legutóbbi bejegyzéseket, terméknaptár alapján témákat talál ki, majd táblázatot készít figyelemfelkeltő sorokkal és felsorolásokkal. Skillként ez egy ötlépéses utasítássá válik: olvasd el az ügyfél tone-of-voice fájlját, a terméknaptárat, ellenőrizd az utolsó 10 bejegyzést az ismétlések miatt, találj ki hét témát típusonként (értékesítésközpontú, szakértői, személyes), végül készíts táblázatot. A „tervezzük meg X ügyfél heti bejegyzéseit” parancs egy órányi előkészületet három perc várakozássá alakít. A marketinges ellenőrzi az eredményt, célzottan módosítja, majd elküldi az ügyfélnek. ### 2. példa. Kiszervezett könyvelő - `monthly-receipts-close` skill (a szerző példája) Amit kézzel csinál: a portfólió minden ügyfelénél havonta exportálja a bankszámlakivonatot, egyezteti a könyvelési rendszerben szereplő kifizetésekkel, megjelöli a be nem sorolt tranzakciókat, előzetes bevételi jelentést készít, majd összehasonlítja a bevétel szerkezetét az előző hónapéval. A skill hatlépéses utasításból és néhány, a bankszámlakivonatok feldolgozására szolgáló shell scriptből áll a `scripts/` mappában. A „zárd le a májust X ügyfélnél” aktiválási kifejezés hatására Claude 4-5 perc alatt olyan jelentést készít, amelyben megjelöli az anomáliákat. ### 3. példa. Online program készítője - `welcome-letter-new-participant` skill Amit kézzel csinál: az új résztvevő fizetett, ezért üdvözlő e-mailt kell írni neki. A jó üdvözlés személyes: figyelembe veszi, melyik csatornáról érkezett, melyik terméket vásárolta meg, melyik csoportba került, és milyen anyagokat kell elküldeni neki. Egy „szia, örülünk neked” sablon ezt nem tudja. A skill arra utasítja Claude-ot, hogy olvassa el a `knowledge/audience.md` fájlt (kik ezek az emberek), a `knowledge/products/.md` fájlt (mit kapnak), valamint az utolsó három üdvözlő e-mailt (az ismétlés elkerüléséhez), majd írja meg az e-mailt a következő szerkezetben: figyelemfelkeltés - termékspecifikumok - az első három lépés - elköszönés. Sokkal gyorsabb, mint kézzel elvégezni. A minőség következetesebb, mert Claude nem felejti el ellenőrizni a három forrást, míg a siető ember ezek közül egyet kihagy. ### Mit NE alakíts skillé? - **Egyszeri feladatok.** Ha évente egyszer csinálod az adóbevalláskor, csak írd le Claude-nak a csevegésben. A skill 3+ ismétlés után térül meg. - **Túl általános feladatok.** A „segíts a marketingben” nem skill, hanem a teljes marketingterület. A „heti tartalomterv” viszont egy konkrét művelet konkrét eredménnyel. - **Ismételhető lépések nélküli feladatok.** Ha a folyamat minden alkalommal más, az nem skill, hanem egyszeri munka. ## Hogyan ír neked skilleket a Skill Creator?
Főbb pontok A Skill Creator az Anthropic meta-skillje, amelyet a `/skill-creator` paranccsal indítottak el. Hat lépésen vezet végig: draft, test, evaluate, iterate, optimize, package. Az eredmény egy használatra kész SKILL.md, amelyet 20 trigger-eval teszttel ellenőriztek (10 esetben aktiválódnia kell, 10-ben nem). Nem programozóknak ez a leggyorsabb módja annak, hogy megírják első működő skilljüket—anélkül, hogy YAML-t kellene tanulniuk vagy Claude-dal vitatkozniuk.
A bökkenő az, hogy elsőre nehéz jó skillt írni. A description gyakran túl szűkre vagy túl tágra sikerül, kimaradnak belőle a felhasználók által ténylegesen használt kifejezések, vagy ütközik egy szomszédos skillel. Az Anthropic erre válaszul kiadta a [skill-creator](https://github.com/anthropics/skills/blob/main/skills/skill-creator/SKILL.md) meta-skillt, amely más skilleket tud létrehozni. Az `anthropics/skills` telepítése után mondd Claude-nak, hogy `/skill-creator` (vagy egyszerűen: „készítsünk skillt a heti jelentéshez”), és kövesd a hatlépcsős munkafolyamatot: 1. **Draft** - a skill-creator kérdéseket tesz fel: mit csináljon a skill, milyen aktiválási kifejezéseket használjon, milyen forrásokat olvasson el, és milyen lépéseket kövessen. Az eredmény a SKILL.md első változata. 2. **Test** - a skill-creator 20 tesztpromptot készít: 10-nek aktiválnia kell a skillt, 10 pedig aktiválási kifejezésnek tűnik, de nem szabad aktiválnia (közeli, de nem egyező esetek). 3. **Evaluate** - minden promptot új csevegésben futtat, és ellenőrzi, hogy aktiválódott-e a skill. Ha olyan helyzetben aktiválódik, amikor nem kellene, vagy nem aktiválódik, amikor kellene, megjelöli az eredményt. 4. **Iterate** - a hibák alapján újrafogalmazza a descriptiont, és újra lefuttatja a teszteket. 5. **Optimize** - végső csiszolás: ellenőrzi, hogy túllépte-e az 1024 karakteres határt, és ütközik-e meglévő projektbeli skillekkel. 6. **Package** - a végleges SKILL.md-t és a referenciafájlokat a megfelelő szerkezetbe csomagolja. A gyakorlatban ez így néz ki: 15-20 percig beszélgetsz Claude-dal, válaszolsz 7-8 pontosító kérdésre, a végén pedig kapsz egy kész, tesztelt skillt, amely a megfelelő kérésekre aktiválódik. További előnye, hogy a `skill-creator` példamutató stílusban mutatja be a SKILL.md írását. Megnyithatod a saját fájlját, és megnézheted a lépések formátumát, hangvételét és szerkezetét. Itt az eszköz önmagát demonstrálja—elolvasod, és megtanulod, hogyan írj sajátot. ## Skills, CLAUDE.md, Subagents, MCP, Hooks: melyiket használd?
Főbb pontok A Claude Code öt különálló elemmel bővíti a működést, és ezek nem felcserélhetők. A CLAUDE.md állandó projektismereteket tárol. A Skills aktiválási kifejezésekre induló, ismételhető munkafolyamatok. A Subagents párhuzamosan, külön kontextusban végeznek munkát. Az MCP külső rendszereket (API-kat, adatbázisokat) kapcsol össze. A Hooks automatikusan reagálnak eseményekre. A vibe-coderek leggyakoribb hibája, hogy mindent a CLAUDE.md-be zsúfolnak, vagy hookot próbálnak skillként használni.
Az általam átnézett projektek leggyakoribb problémája, hogy a CLAUDE.md egyszerre tartalmaz projektutasításokat, lépésről lépésre követhető publikálási útmutatót, commit-sablont és adatbázis-leírást. Ez túlterheli a kontextust, és a gyakorlatban sem működik: Claude nem hajtja végre a „ha a felhasználó publikálást kér” utasítást, mert a modell az egész CLAUDE.md-t általános kontextusként kezeli, kifejezett aktiválási feltételek nélkül. A megoldás az, hogy minden elemet a megfelelő komponenshez rendelsz: | Mi | Mikor használd | Példa | |----|----|----| | **CLAUDE.md** | Mindig szükséges tudás | „A projektnek meghatározott nyelve van”, „ne használj hosszú gondolatjelet a szövegben”, „a márkanevet ‘o’-val írjuk” | | **Skills** | Aktiválási kifejezéssel induló, ismételhető folyamat | „Telepítés éles környezetbe”, „heti bejegyzésterv”, „zárd le az ügyfél havi könyvelését” | | **Subagents** | Párhuzamos munka vagy nagy kontextus elkülönítése | „Biztonsági audit, amíg én új funkciót tervezek”, „a kódbázis áttekintése külön munkamenetben” | | **MCP** | Külső rendszer csatlakoztatása | „Adatok lekérése a CRM-ből”, „feladatok lekérése a nyomkövetőből”, „webhely ellenőrzése böngészőben” | | **Hooks** | Automatikus válasz egy eseményre | „Ellenőrzés futtatása Edit után”, „veszélyes parancsok blokkolása”, „Telegram-értesítés küldése befejezéskor” | Röviden, a kép egyszerű logikára vezethető vissza: a Skills és az MCP a legtöbb munkafolyamatot lefedi; a Hooks automatizálja a rutinokat—kódellenőrzéseket, teszteket és védőkorlátokat. A Subagents akkor szükségesek, ha nagy a kontextus. A leggyakoribb hiba, hogy valaki skill helyett subagentet készít. ### Döntési fa Amikor arra gondolsz, hogy „Szeretném, ha Claude elvégezné X-et”: 1. **Erre a tudásra mindig szükség van?** Például: „A projektnek meghatározott nyelve van” vagy „nem használunk em-dash-t.” → Tedd a `CLAUDE.md` fájlba. 2. **Ez egy aktiválásra induló eljárás, amelyet jelenleg kézzel végzel?** Például: „Minden hétfőn jelentést írok.” → Készíts belőle **skillt**. 3. **Szükséged van hozzáférésre egy külső rendszerhez?** Például a Stripe API-hoz vagy a CRM-edhez. → Csatlakoztass egy **MCP-servert**. 4. **A Claude Code automatikusan reagáljon egy eseményre?** Például minden Edit után fusson lintelő. → Írj egy **hookot**. 5. **Nehéz a feladat, felemészti a teljes kontextust, és közben mást is párhuzamosan kell csinálnod?** → Futtasd **subagentként**. Egy vállalkozó vibe-coder feladatainak 90%-a az 1-3. kategóriába esik. A Hooks és a Subagents magasabb szintű eszközök arra az időszakra, amikor már túlléptél az „egyszerre egy feladat” szakaszán. ### A Slash Commands és a Skills ugyanaz Fontos változás a Claude Code-ban: a régi slash-command rendszer (`.claude/commands/`) és a skillek lényegében összeolvadtak. A `.claude/commands/deploy.md` és a `.claude/skills/deploy/SKILL.md` fájl egyaránt létrehozza a `/deploy` parancsot. Ha a nevek egyeznek, a skill élvez elsőbbséget. Ha tehát még a régi slash-command formátumot használod, térj át a skillekre; a szintaxis világosabb, a lehetőségek pedig bővebbek. ## 7 hiba, amely miatt nem működik egy skill
Főbb pontok A leggyakoribb skillproblémák nem Claude hibái, hanem magában a skillben vannak. Aktiválási kifejezések nélküli description, túlterhelt, 2,000 soros SKILL.md, két hasonló, egymással ütköző skill vagy az a próbálkozás, hogy „mindent” letölts a marketplace-ről. Mindegyik hiba a skill aktiválását vagy működését rontja el.
### 1. Nincs aktiválási kifejezés a descriptionben: a skill nem indul el Tünet: megírtad a skillt, ellenőrizted a szerkezetét, minden érvényes, Claude mégsem hívja meg a felhasználói kérésekre. Az ok szinte mindig ugyanaz: a description ilyen: „Segéd tartalomíráshoz.” Claude nem tudja, milyen kifejezésekre reagáljon. Javítás: tegyél 3-5 tényleges felhasználói kifejezést idézőjelben közvetlenül a descriptionbe. ### 2. A SKILL.md több mint 500 soros: lankad a figyelem Az Anthropic [kifejezetten azt javasolja](https://code.claude.com/docs/en/skills), hogy a fájltörzs legfeljebb 500 soros legyen. Ha az utasításaid 2,000 sor hosszúak, Claude elveszíti a fókuszt, csak részben követi a lépéseket, és összekeveri azok sorrendjét. Javítás: helyezd át a nagyobb részeket közeli fájlokba—`examples/`, `references/`, `scripts/`—, és hivatkozz rájuk a SKILL.md-ből. ### 3. Egy skill „minden tartalomhoz” három kisebb helyett Csábító megoldás: egy nagy `content` skillbe kerül a Telegram-bejegyzés, a landing page és az e-mail. Nem működik. A skill rossz kérésekre aktiválódik, összekeveri a módszertanokat, és átlagos eredményt ad. Javítás: egy skill = egy ismételhető művelet. Ha tényleg három rutinfeladatod van a „tartalom” körül, készíts három skillt: `telegram-post`, `landing-section`, `email-broadcast`. ### 4. Nincs „mikor NE használd” rész a skillben: ütközések Tünet: két hasonló skill van a projektben, és Claude a rosszat hívja meg. Például az egyik skill e-mailes hírlevélhez készült, a másik pedig kifejezetten a program résztvevőinek szóló üdvözlő e-mailekhez. A „ne aktiváld, ha a kérés általános levelezőlistáról szól” kifejezett kikötés nélkül az üdvözlő e-mailes skill minden „e-mail” említésre aktiválódik. Javítás: fogalmazd meg a negatív eseteket a descriptionben. ### 5. 50 skill egy projektben: a descriptionök csonkolódnak A [Claude Code dokumentációjából](https://code.claude.com/docs/en/skills):

A skillek nevei mindig szerepelnek, de ha sok skill van, a descriptionök csonkolódnak, hogy beleférjenek a karakterkorlátba; emiatt eltűnhetnek a kulcsszavak, amelyek alapján Claude egyezteti a kérést. Keret - a modell kontextusablakának 1%-a.

— Claude Code-dokumentáció, https://code.claude.com/docs/en/skills
Ha 50 skillgyűjteményt töltesz le a marketplace-ről, néhány description csonkolódik. Eltűnhetnek azok a kulcsszavak, amelyekre számítottál. Javítás: az aktív projektben tartsd meg a 10-15 leghasznosabb skillt. A többit tartsd inaktív archívumban minden felfedezhető skillkönyvtáron kívül, például a saját anyagaid között egy külön `skill-archive/` mappában. Csak a szükséges skilleket telepítsd projekt- vagy személyes hatókörbe. A `~/.claude/skills/` telepített személyes könyvtár, amely több projektben is látható, ezért az odahelyezés nem vonja ki a skilleket a felfedezésből. ### 6. Nem ellenőrzött forrásból származó skillek: biztonsági kockázat Az Anthropic erre figyelmeztet a [hivatalos dokumentációban](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview):

Csak megbízható forrásból származó skilleket használj: olyanokat, amelyeket magad készítettél vagy az Anthropic-tól kaptál. Egy rosszindulatú skill arra késztetheti Claude-ot, hogy olyan módon hívjon meg eszközöket vagy futtasson kódot, amely eltér a skillben megadott céltól.

— Az Anthropic Agent Skills áttekintése, https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview
Egy véletlenszerű GitHub-tároló olyan skillt tartalmazhat, amely már az első meghíváskor kiszivárogtatja az API-kulcsaidat. Javítás: telepítés előtt nyisd meg a SKILL.md-t, és olvasd el. Fontos projektekben ne futtass ismeretlen szerzőktől származó skilleket. ### 7. Tudásmappa nélküli skillből „átlagos ChatGPT” lesz A legfinomabb és leggyakoribb kerülendő minta. A skill módszertan, de a módszertan kontextus nélkül semmit sem ér. Ha olyan „készíts üdvözlő e-mailt” skillt írsz, amely mellett a projektben nincs a közönséget leíró fájl és márkahangfájl, Claude olyan átlagos ChatGPT-e-mailt ír, amely megkülönböztethetetlen bárki másétól. A skill akkor működik a legjobban, ha már felépítetted a projekt [Second Brainjét](https://ailoot.ai/blog/hu/claude-code-second-brain/) a [CLAUDE.md-ről szóló útmutatóban](https://ailoot.ai/blog/hu/claude-md-template/) ismertetett elvek szerint. Először építsd fel a tudásstruktúrát, aztán hozz létre skilleket, amelyek erre támaszkodnak. Ha fordítva csinálod, rutinszerű, átlagos minőségű munkát kapsz a személyre szabott, saját stílusú munka helyett. ## Hogyan építsd meg az első skilledet 30 perc alatt?
Főbb pontok Lépésről lépésre követhető recept az első működő skill elkészítéséhez: válassz egy ismétlődő műveletet, írd le a lépéseket, hozd létre a mappaszerkezetet, írd meg a descriptiont a képlet alapján, teszteld 5-8 prompttal, majd addig módosítsd, amíg a megfelelő helyzetekben nem aktiválódik. Az első skill reális elkészítési ideje 30-40 perc. Minden további 10-15 percet vesz igénybe, mert addigra ismerőssé válik a formátum.
Íme a konkrét terv, amelyet a projektjeim első skilljeinek elkészítéséhez használtam: ### 1. lépés. Válassz egy ismétlődő műveletet Nyisd meg az elmúlt hónap naptárát. Keress olyan feladatot, amelyet már legalább 4-5 alkalommal elvégeztél, és minden alkalommal 30-60 percet vett igénybe. Ne általános „marketing” legyen, hanem konkrét dolog: „hétfői értékesítési jelentés”, „új ügyfél beléptetése” vagy „árlista frissítése promócióhoz.” Minél pontosabban fogalmazol, annál egyszerűbb lesz a skill, és annál tisztább az aktiválási feltétel. ### 2. lépés. Írd le kézzel a folyamatot Egy külön fájlban vagy Claude-dal folytatott csevegésben (nem a skillhez, hanem vázlatként) írd le az általad követett lépéseket: ``` 1. Nyisd meg az ügyfél-adatbázist 2. Szűrj a "awaiting welcome email" állapotra 3. Ellenőrizd, melyik csatornáról érkezett az ügyfél 4. Keresd ki a csatornához tartozó e-mail-sablont a "templates" mappából 5. Töltsd ki a nevet, a terméket és a kezdés dátumát 6. Küldd el ``` Ez még nem skill, hanem jegyzet. De e jegyzetek nélkül már a SKILL.md írásának kezdetén összezavarodsz. ### 3. lépés. Hozd létre a mappaszerkezetet ```bash mkdir -p .claude/skills/welcome-email-new-client touch .claude/skills/welcome-email-new-client/SKILL.md ``` Ha viszont minden projektedben használni szeretnéd, tedd a `~/.claude/skills/` mappába. ### 4. lépés. Írd meg a SKILL.md-t a sablon alapján Vázlat: ```markdown --- name: welcome-email-new-client description: | Új ügyfél számára készít üdvözlő e-mailt a megszerzési csatornához tartozó sablon használatával. Aktiválási kifejezések: "írj üdvözlő e-mailt X új ügyfélnek", "Y új résztvevő bevezetése", "üdvözlő e-mail a Z csatornáról érkezett ügyfélnek". Ne aktiváld, ha a kérés általános levelezőlistáról vagy e-mail-kampányról szól—ezek más skillek. --- # Üdvözlő e-mail új ügyfélnek ## Lépések 1. Olvasd el a `knowledge/audience/segments.md` fájlt - milyen ügyfélszegmenseink vannak 2. Olvasd el a `knowledge/templates/welcome/` mappát - csatornánkénti sablonok 3. Azonosítsd az ügyfél csatornáját a kérés kontextusából 4. Illeszd be az ügyfél nevét, a termék nevét és a kezdés dátumát 5. Ellenőrizd a hosszt—legfeljebb 800 karakter lehet 6. A végleges e-mail szövegét másolásra kész formátumban add meg ## Fontos - Ne használj olyan megszólítást, mint „kedves barátom” vagy „helló”—fogalmazz természetesen - Egy bekezdés, egy gondolat - Egy cselekvésre ösztönző felhívással zárj, ne kettővel ``` ### 5. lépés. Teszteld 5-8 prompttal Nyiss egy üres csevegést a Claude Code-dal ebben a projektben. Próbálj ki 5 ténylegesen használt kifejezést, valamint 3 hasonlót, amelyek nem aktiválhatják a skillt: Aktiválódnia kell: - „Írj üdvözlő e-mailt Ivanov új ügyfélnek” - „Vezess be egy új résztvevőt, aki megvásárolta az X programot” - „Üdvözlő e-mail egy Instagramról érkezett ügyfélnek” Nem aktiválódhat: - „Küldj promóciós e-mailt a teljes listának” - „E-mail-kampány az újévi ünnepekre” - „Írj utánkövető levelet annak az ügyfélnek, aki még nem fizetett” Mindegyiknél ellenőrizd, aktiválódott-e a skill. Ha rossz esetekben is aktiválódik, szűkítsd a descriptiont. Ha nem aktiválódik, amikor kellene, bővítsd az aktiválási kifejezéseket. ### 6. lépés. Módosítsd a descriptiont Minden sikertelen teszt után csak a descriptiont szerkeszd—az utasítástörzshöz ne nyúlj. 2-3 iteráció után a skill megbízhatóan aktiválódni kezd. Mentsd el, commitold, majd használd nap mint nap. Utolsó tanács: ne próbáld tökéletesre csiszolni az első skilledet. Először működjön. A finomítás majd az ötödik vagy tizedik skill után jön, amikor felismered a megfogalmazásodban és Claude válaszaiban megjelenő mintákat. Válassz ki erre a hétre egy ismétlődő feladatot a naptáradból, szánj rá 30 percet, és kövesd a fenti hat lépést. Claude ezután a módszertanod szerint fog dolgozni a találgatás helyett.
### Források - [Claude kibővítése skillekkel - Claude Code-dokumentáció](https://code.claude.com/docs/en/skills) - [Agent Skills áttekintése - Claude Platform-dokumentáció](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) - [Ügynökök felkészítése a valós világra Agent Skills segítségével - Anthropic Engineering Blog](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills) - [anthropics/skills - hivatalos tároló skill-creatorral](https://github.com/anthropics/skills) - [Skill Creator SKILL.md - a trigger-evals módszertan forrása](https://github.com/anthropics/skills/blob/main/skills/skill-creator/SKILL.md) - [vercel-labs/agent-skills - tervezési irányelvek](https://github.com/vercel-labs/agent-skills) - [Az Agent Skills nyílt szabványa - specifikáció](https://agentskills.io)
A működő beállítás: **AI-clone + Second Brain + Context Engineering**. Egy módszertan három része. Ha az Ailooton keresztül szeretnél hozzáférni AI-modellekhez, nézd meg az [Ailootot](https://ailoot.ai/). ## Kérdések és válaszok: Claude Code Skills 2026-ban: hogyan építs saját Skills-könyvtárat ### Inaktívvá válik egy skill, ha a ~/.claude/skills/ mappába helyezem? Nem. Ez a telepített személyes hatókör könyvtára, amely a projektjeidben elérhetővé teszi a skillt. A nem használt csomagokat minden felfedezhető skillkönyvtáron kívüli archívumban tartsd, és csak az éppen szükséges skilleket telepítsd. ### Hogyan ellenőrizhetem, hogy a leírás megfelelően aktiválódik-e? Próbálj ki öt olyan kérést, amelynek meg kell hívnia a skillt, és három hasonlót, amelynek nem. Használj friss beszélgetéseket, rögzítsd, melyik skill töltődött be, és módosítsd a leírást, ha valódi kérésnél nem aktiválódik vagy közeli, de más kérésre is illeszkedik. ## Ailoot · A vállalat és projektportfóliója Az Ailoot felhalmozott működési tapasztalatra, széles ügyfélkörre, stabil szolgáltatásra és folyamatos KPI-ellenőrzésre épít. A vállalat és projektportfóliója: ügyfelek milliói; havi értékesítés milliárdos nagyságrendben. Az Ailoot ezt a működési tapasztalatot használja az ügyfelek termékeiben, ágenseiben, alkalmazásaiban és automatizálásaiban elérhető AI-funkciók API-hozzáféréséhez.