Mi az a skill, és hogyan építsd meg az első Claude-ügynöködet?

Miben más egy skill, mint egy prompt?

A prompt egy beszélgetésre szól. A skill újrahasznosítható, és csak akkor töltődik be, amikor szükség van rá.

Ezért hívjuk a skillel felszerelt Claude-ot ügynöknek: nem kell újra és újra elmagyaráznod neki a feladatot, ő tudja, mikor és hogyan kell elvégezni.

Hogyan dönti el Claude, mikor használja a skillt?

Három lépcsőben, és ez a skill egyik legokosabb tulajdonsága. Az Anthropic dokumentációja ezt fokozatos betöltésnek nevezi:

1. 1Név és leírás. Ez mindig ott van Claude előtt, skillenként nagyjából 100 token. Ebből tudja, hogy létezik a skill, és mire való.
2. 2A SKILL.md törzse. Csak akkor töltődik be, amikor a kérésed illik a leíráshoz. A dokumentáció szerint ez jellemzően 5000 token alatt marad.
3. 3A további fájlok. A sablonokat, referenciákat és szkripteket Claude csak akkor nyitja meg, amikor a munka adott pontján szüksége van rájuk.

A gyakorlati következmény: akár több tucat skill is lehet bekapcsolva egyszerre, mert amíg nem kellenek, szinte semmi helyet nem foglalnak. És mindenen a leírás múlik. Ha az homályos, Claude nem fogja tudni, mikor kell a skillt elővennie.

Mi van egy SKILL.md fájlban?

Két rész: egy rövid fejléc és a törzs. Egy egyszerű példa:

---

name: blogcikk-iro

description: Blogcikket ír a cég blogjára rögzített szerkezetben. Használd, ha blogcikket, cikktervet vagy cikkátírást kérnek.

---

# Blogcikk-író

## Munkafolyamat

1. Kérd el vagy keresd meg a témához tartozó friss forrásokat.

2. Írd meg a cikket: rövid válasz az elején, kérdés formájú alcímek, GYIK a végén.

3. Futtasd le az ellenőrzőlistát, és csak utána add le.

## Tiltólista

- Forrás nélkül nem állíthatsz számot.

- Kerüld a töltelékszavakat.

## Ellenőrzőlista

- Minden számnak van forrása?

- Megvan a GYIK, legalább hat kérdéssel?

A fejléc szabályai:

• name: legfeljebb 64 karakter, csak kisbetű, szám és kötőjel. A „claude” és az „anthropic” szó nem szerepelhet benne. A mappa nevének meg kell egyeznie vele.
• description: két dolgot kell elmondania: mit csinál a skill, és mikor kell használni. A claude.ai súgója szerint legfeljebb 200 karakter, ezért érdemes tömörnek maradni.

A törzsben nincs kötelező szerkezet, de a jól működő skillekben szinte mindig van munkafolyamat, tiltólista, ellenőrzőlista és legalább egy példa a jó eredményre.

Mit tehetsz még a mappába?

Mindent, ami a feladathoz kell, és ami túl hosszú lenne a SKILL.md-ben:

• referenciafájlok: arculati leírás, szakmai tudásanyag, a cég hangnemének mintái,
• sablonok: például egy HTML-sablon, amiből Claude képet renderel,
• szkriptek: kis programok, amelyeket Claude lefuttat, például egy fájl átalakítására.

Fontos, hogy a SKILL.md-ben hivatkozz rájuk („a színeket lásd az arculat.md fájlban”), mert Claude ebből tudja, hogy léteznek, és mikor kell megnyitnia őket.

Hogyan építsd meg lépésről lépésre?

1. 1Válassz egy feladatot. Olyat, amit rendszeresen csinálsz ugyanúgy, és amiről meg tudod mondani, mikor jó.
2. 2Csináld meg egyszer Claude-dal, kézzel. Javíts addig, amíg az eredményt ki mernéd adni a kezedből.
3. 3Kérd meg Claude-ot, hogy írja meg belőle a skillt. A javításaid legyenek benne szabályként, mert azok a legértékesebb sorok.
4. 4Írd meg pontosan a leírást. Mit gyárt, milyen helyzetben, milyen szavakra kell elindulnia.
5. 5Tedd a fájlokat egy mappába, és csomagold ZIP-be. A mappa legyen a ZIP gyökerében, ne a fájlok külön.
6. 6Töltsd fel. A Claude beállításaiban a Skills résznél tudsz saját skillt feltölteni. Ehhez Pro, Max, Team vagy Enterprise csomag és bekapcsolt kódfuttatás kell.
7. 7Teszteld. Írj néhány kérést, amelyre a skillnek el kell indulnia, és nézd meg, betöltötte-e Claude. Ha nem, a leírást kell pontosítani.

A finomhangolás az első éles futások alatt történik. Minden javítást írj vissza a SKILL.md-be, így ugyanazt a hibát nem kell kétszer kijavítanod.

Hol működnek a skillek?

A dokumentáció szerint a saját skillek nem szinkronizálódnak a felületek között, mindegyikre külön kell feltölteni őket. A skillek nyílt szabványra épülnek (Agent Skills), így a jól megírt skill más eszközökben is használható.

Mire figyelj a biztonság miatt?

• Csak megbízható forrásból tölts fel skillt, az ismeretlen eredetűt előtte nézd át.
• A szkriptekkel légy óvatos, mert Claude le is futtatja őket.
• Jelszót és API-kulcsot soha ne írj a skillbe.