Claude Code Skills 2026-ban: hogyan építs saját Skills-könyvtárat

Ailoot dokumentáció: API, kulcsok és beállítás.

Mi az a skill a Claude Code-ban, és miért nem csupán „egy nagyobb prompt”?#

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 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).

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 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

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?#

Íme egy minimális példa—húsz sor, és a skill készen is áll:

---
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ó 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:

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?#

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

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 útmutatója egyenesen megfogalmazza az ajánlást:

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):

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?#

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. 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:

/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:

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. 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 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 (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é?#

Ü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/<product>.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?#

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 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?#

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:

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#

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, 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:

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:

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 a CLAUDE.md-ről szóló útmutatóban 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?#

Í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

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:

---
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.

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.