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.
Ennyi kötelező mezője van a frontmatter blokknak, a név és a leírás. Claude Code a leírás alapján dönti el, mikor releváns a Skill, ezért ez a pár sor dönti el a Skill sorsát.
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.
Gyenge leírás
„Segít a dokumentumokkal."
- Túl általános
- Vagy soha nem, vagy mindig előjön
- Nincs benne feladattípus vagy kulcsszó
Jó leírás
„Havi pénzügyi riport PDF készítése a céges sablonnal. Ne használd prezentációkhoz."
- Megnevezi a feladattípust
- Olyan kifejezéseket használ, amikkel a felhasználók hivatkoznának rá
- Azt is jelzi, mikor NE aktiválódjon
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.
- Írd le a folyamatot lépésről lépésreEz az az instrukció, amit Claude Code követni fog, amikor a Skill aktiválódik.
- Adj konkrét példákatMutasd meg a várt kimenetet, ne csak körülírd.
- Sorold fel a gyakori hibákatAmit el kell kerülni, azt érdemes kimondani.
- Tartsd szűken a fókusztHa a Skill túl sok mindenre terjedne ki, bontsd több kisebb Skillre.
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.
Személyes Skill
- Csak az adott felhasználónál aktív
- Minden projektjében elérhető
- Saját munkastílushoz kötött tudás
Projektszintű Skill
- A csapattal együtt terjed
- Mindenki ugyanazt a verziót használja
- Több emberre vonatkozó folyamatokhoz
Workshop
AI Transformation Day
Egésznapos, vezetőknek szóló program. Feltérképezzük, hol tart a szervezet, mi az első reális lépés, és milyen belső feltételek szükségesek a sikerhez. A nap végén konkrét, prioritizált cselekvési lista.
Érdekel a program →