Az első Skill elkészítése

A SKILL.md fájl felépítése

Minden Skill egy SKILL.md nevű fájlból indul ki. A fájl elején egy úgynevezett frontmatter blokk áll, ami két kötelező mezőt tartalmaz, a Skill nevét és a leírását. Ez alatt következik a tényleges tartalom, szabad Markdown formátumban, ahol részletesen leírható, hogyan kell elvégezni a feladatot.

A frontmatter blokk azért fontos, mert Claude Code ez alapján dönti el, mikor releváns az adott Skill. A leírás mezőt ezért nem általánosan, hanem konkrétan érdemes megfogalmazni, pontosan megnevezve, milyen helyzetben, milyen kulcsszavakkal vagy feladattípusokkal kapcsolatban érdemes előhívni a Skillt.

A jó leírás megírása

A leírás mező a Skill legfontosabb része, mert ez alapján történik az illesztés a felhasználó kérése és a Skill között. Egy gyenge leírás, mint amilyen a segít a dokumentumokkal, túl általános, és vagy soha nem, vagy mindig előjön, egyik sem hasznos. Egy jó leírás konkrét, megnevezi a feladattípust és azokat a kifejezéseket, amelyekkel a felhasználók valóban hivatkoznának rá.

Érdemes a leírásba beleírni azt is, mikor NE használja Claude Code az adott Skillt, ha ez releváns, mert ez tovább pontosítja az illesztést, és elkerülhető, hogy a Skill olyan helyzetekben is aktiválódjon, ahova nem illik.

A tartalom megírása

A frontmatter után szabadon írható tartalom a tényleges instrukció, ez az a rész, amit Claude Code el fog olvasni és követni fog, amikor a Skill aktiválódik. Érdemes lépésről lépésre leírni a folyamatot, konkrét példákkal illusztrálni a várt kimenetet, és megemlíteni azokat a gyakori hibákat, amiket el kell kerülni.

Egy jól megírt Skill nem próbál mindent lefedni, inkább egyetlen, jól körülhatárolt feladatra fókuszál. Ha egy Skill túl sok mindenre próbál kiterjedni, érdemesebb inkább több, kisebb Skillre bontani, amelyek mindegyike egy konkrét részfeladatot old meg.

Hova kerül a Skill fájl

A Skillek egy meghatározott mappaszerkezetben tárolódnak, projektszinten vagy a felhasználó saját, minden projektre érvényes beállításai között. A projektszintű Skillek a csapattal együtt terjednek, míg a személyes Skillek csak az adott felhasználónál aktívak, minden projektben.

Érdemes már a legelső Skillnél eldönteni, hogy az adott tudás csak a sajátunk marad, vagy érdemes-e a csapattal is megosztani. Ha egy folyamat több emberre is vonatkozik, célszerűbb projektszinten tárolni, hogy mindenki ugyanazt a verziót használja.

Forrás

Az Anthropic Claude Code hivatalos Skills dokumentációjának és az anthropic.skilljar.com Introduction to Agent Skills kurzusának magyar feldolgozása.