Mi az a skill, és hogyan írd meg az elsőt

Ebben a leckében három fogalmat építünk fel és gyakorlatba viszünk: skill-folder, minimal viable skill, skill-iteráció. A végére lesz egy működő, élesben használható első saját skilled, és tudni fogod, milyen logika mentén jönnek utána a többiek.

A skill mint munkaköri leírás

A skill a Claude munkaköri leírása egy konkrét feladatra. Pont annyira mély vagy felszínes, amennyit egy új belépő szakember kezébe nyomnál: „ezt csináljuk, így csináljuk, ezekkel az anyagokkal".

Vezetői intuíció a háttérben: amikor egy új kolléga első napján leül az asztalához, mit adsz át neki? Brand-guide-ot, formátum-sablonokat, a „nálunk így megy" leírást, mintaszerű korábbi kimeneteket. Két hét múlva már magától tudja. A skill ugyanez az onboarding-gesztus, csak a Claude számára, és két hét betanulás helyett az első használattól érvényes.

Egy mappa, nem egy fájl

A skill nem markdown-fájl. A skill egy mappa, amiben minden együtt él, amire a Claude-nak szüksége lehet ahhoz, hogy a képességet kompetensen ellássa. Ez a különbség egy „leírt tudás" és egy valódi képesség + eszköztár között.

A három réteg, sorrendben

(1) A munkaköri leírás: SKILL.md. Egyetlen kötelező elem. Itt áll, hogy ki ez a skill, mikor van rá szükség, hogyan dolgozik. A többi mind csak akkor kerül a mappába, ha tényleg kell.

(2) Mellékletek, amiket a Claude tényleg használ. Logó-fájlok (PNG, SVG), brand-tokenek (tokens.css), példa-outputok, korábbi sikeres minták. A brand-skill mellékelve adja át a logót, és a Claude azt teszi be a slide-ba. A különbség jelentős: egy leírás értelmezhető tévesen, egy fájl önmagát adja át.

A lényeges üzenet: a skill képesség + eszköztár, nem leírás. Mint egy szakember, aki nemcsak tudja, hogy kell csinálni, hanem van is hozzá megfelelő szerszáma. A „mappa, nem fájl" elv az, ami a skillt operatívan használhatóvá teszi, hogy ne csak elméletileg jó tanácsot adjon, hanem konkrét munkát végezzen konkrét anyagokkal.

A trigger, vagy: a tudás magától jelentkezik

A trigger nem technikai részlet. Ez a delegálás működő mechanizmusa. Egyszer leírod, hogy mikor van rád szükség, és onnantól a Claude magától hívja be a skillt, amikor a feladatban felmerül a téma.

Hogyan néz ki ez a gyakorlatban:

• Írsz egy emailt egy ügyfélnek → a brand-skill magától aktiválódik, mert a feladatban felismerhető, hogy a céged nevében kommunikálsz.
• Készítesz egy briefet → a hétfői-brief-skill magától aktiválódik, mert a feladatban szerepel a „brief" szó és a strukturált forma jegye.
• Vegyes feladat, brand-konform vezetői összefoglaló a Notion-számokra → több skill egyszerre aktiválódik. A brand-skill adja a hangvételt, a brief-skill a formátumot, a Notion-MCP az élő adatot.

A részlet, ami a SKILL.md fájlban ezt mozgatja, egy néhány soros YAML-blokk a fájl tetején (lásd a következő szakaszban). Az érdemi tudás a delegálás-élményben van: szabadulsz a „kérlek, ne felejtsd el" terhétől, a syntax csak a csomagolás.

Az első saját skilled: kezdd kicsiben, a hiba a tananyag

A skill nem mestermű, kísérlet. 8-15 sor, ma délután kipróbálva, és a használat tanítja, mit kell hozzáírni. A jó első skill inkább működjön rosszul, mint létezzen tervként.

Setup, 2 perc

A skilleknek saját helyük van a gépeden: a Claude skill-mappája. Nem kell hozzá fejlesztői eszköz, és ez már maga az első delegálás: a Claude appban (Claude Code-ban vagy Coworkben) megkéred a Claude-ot, hogy készítse elő. A mappába egyetlen kötelező fájl kerül: a SKILL.md, a munkaköri leírás. Mellé jönnek később (ha kell) példák, sablonok, kód.

Mielőtt a hogyan-ba kezdenénk, nézzünk meg egy konkrét, élő mintát. A „Hétfő reggeli brief" skill jól mutatja, milyen egy kicsiben induló első skill: a teljes fájl-tartalom nem több egy képernyőnyi szövegnél, és ennyi az első saját skill.

---
name: hetfoi-brief
description: >
  Hétfő reggeli vezetői brief: max 1 oldal, 4 bullet,
  ténykezelő hangvétel, mindig a következő hét akciójával zár.
  Használd, ha valaki hétfői briefet, heti vezetői összefoglalót
  vagy "monday brief"-et kér.
---

# Hétfői brief, formátum

A brief 4 bullet, ebben a sorrendben:
1. **Múlt hét számai**: bevétel, leadek, kulcs-projektek státusza. 2-3 mondat, számokkal.
2. **Mit tanultunk**: egy konkrét észrevétel (jó vagy rossz), amire figyelni kell. 1 mondat.
3. **Akadályok**: ha van blokkoló, csak egy sor: mi, ki oldja meg, mikorra. Ha nincs, kihagyjuk.
4. **Következő hét fókusza**: egy mondat, mi a fő dolog, ami ezen a héten számít.

Hangvétel: tényközpontú, „bevétel +12%, részben a Q3-leszállítás csúszott át" típusú
mondatok. Felsőbb fok és minősítés nélkül. Hossz: max 1 oldal, semmi kivétel.

A --- közötti YAML-blokk a fájl tetején nem syntax-fetisizmus: ez az a néhány sor, ami a delegálás-mechanizmust (§3) működteti. A description szövegében megfogalmazott helyzetekre (hétfői brief, heti vezetői összefoglaló) a Claude magától behívja ezt a skillt, neked nem kell minden chatben felemlítened. Az alatta lévő törzs a munkaköri leírás. 4 bullet, hangvétel, hossz. Semmi több. Aki olvassa, ennyiből el tudja kezdeni a munkát.

Hogyan formálódik használat közben

Az első output majdnem biztosan hibás valahol, és ez nem baj, ez a tervezett munkafolyamat. A hiba megmutatja, mit hagytál ki a skillből. A ciklus négy lépés:

1. Megírod 8-15 sorban, ahogy fent.
2. Új beszélgetésben kipróbálod: „Készíts hétfői briefet a múlt heti számokra: [3 sor tényadat]."
3. Iterálsz (skill-iteráció): amit elsőre rosszul csinált, azt a skill törzsébe írod. Túl hosszú? „Mindig max 1 oldal, semmi kivétel." Rossz hangvétel? Egy sor példa-mondatokkal. Hiányzó bullet? Explicit szabály.
4. Újra kipróbálod. Két iteráció után tipikusan stabil. Három után már hetekig nem nyúlsz hozzá.
5. Ellenőrzöd, hogy él-e. Nyiss egy vadonatúj beszélgetést, és kérdezd meg: „Milyen skillek érhetők el nálam?" Ha a hétfői brief szerepel a listában, a Claude látja, és be is tudja tölteni.

Innen hova: a modul további 4 leckéje

Van egy működő első skilled, a hétfői brief. Innen a következő 4 lecke a saját skill-csomagodat építi fel, és mindegyikben egy konkrét, telepíthető skill születik a délután végére.