# Codex Skills: Skill létrehozása ismétlődő feladatokhoz > A SKILL.md felépítése, betöltési útvonalak, explicit és automatikus meghívás, eredménykritériumok, valamint egy skill átvitele Claude Code-ba. Source: https://ailoot.ai/blog/hu/codex-skills/ Canonical: https://ailoot.ai/blog/hu/codex-skills/ Language: hu Publisher: Ailoot (https://ailoot.ai/) Translation: guide-084 Revision: sha256-d5e2c540fc861a425b694919a6b89b94f3a8f854a2dd781abe6c1f79d1c2a779 Ha hetente ötször ugyanazt magyarázod el a Codexnek—hogyan formázzon meg egy jelentést, válogasson az e-mailek között, vagy készítsen szöveget a stílusodban—egyszer leírhatod ezeket az utasításokat egy skillben. Ezután az ügynök a leírása alapján megtalálhatja, amikor a leírás illik a feladathoz, vagy explicit módon is meghívhatod. A skill egy egyszerű mappa, benne egy `SKILL.md` nevű szövegfájllal; az alapvető használatához nincs szükség programozásra. Az alábbiakban bemutatjuk a skill felépítését, azt, hol keresi a Codex, hogyan hozható létre lépésről lépésre, valamint hogyan választható ki egy modell a költség alapján. A parancsok és árak az OpenAI hivatalos dokumentációján alapulnak, 2026. szeptember 20-i állapot szerint. A Codex telepítésére vonatkozó utasításokat itt nem ismételjük meg; ezek a [Codex az OpenAI-tól: Mi ez, hogyan telepíthető és futtatható](https://ailoot.ai/blog/hu/openai-codex-install/) útmutatóban találhatók. [Az Ailoot használatával kapcsolatos gyakorlati tudnivalók a dokumentációban találhatók](https://ailoot.ai/docs/). ## Mi az a skill a Codexben?
Fő tanulság A Codex-skill egy `SKILL.md` fájlt tartalmazó mappa, amely leír egy folyamatot: mit kell tenni, mire kell alapozni, és milyen a jó eredmény. A Codex kezdetben csak a skillek nevét és leírását tartja a kontextusban, és akkor tölti be a teljes utasításokat, amikor úgy dönt, hogy használni fogja valamelyiket.
A formátum neve Agent Skills. Ez egy nyílt szabvány, amelyet eredetileg az Anthropic fejlesztett ki, és az agentskills.io oldalon tett közzé. Több ügynök is támogatja, köztük a Codex, a Claude Code és más kompatibilis kliensek. Egy kizárólag szöveges utasításokat tartalmazó egyszerű skill a mappa másolásával átvihető közöttük. Ha szkriptek, függőségek vagy `agents/openai.yaml` fájl is tartozik hozzá, az átvitel után ellenőrizd a skillt: egyes beállítások adott kliensre vonatkoznak. Ezt a betöltési módszert fokozatos feltárásnak nevezik. Az ügynök a skill nevét és leírását használja annak meghatározására, hogy mikor releváns. Ha egy feladat illik a leíráshoz, az ügynök elolvassa a teljes `SKILL.md` fájlt, és követi az utasításait. Így több tucat skillt is tárolhatsz a Codexben anélkül, hogy az összes utasítás betöltődne a kontextusba: a kezdeti lista legfeljebb a kontextusablak 2%-át foglalja el (vagy 8 000 karaktert, ha az ablak mérete nem ismert). Ha sok skill van, a Codex először lerövidíti a leírásukat; nagyon nagy készlet esetén némelyik kimaradhat a listából, és erről értesítést kapsz. A skill könnyen összetéveszthető az `AGENTS.md` fájllal. A Codex minden projektszakaszban elolvassa ezt a fájlt. Állandó szabályokat tartalmaz: a technológiai stacket, a konvenciókat és a kódolási stílust. A skill igény szerint töltődik be, amikor egy feladat illik hozzá. Ezért az állandó szabályokat az `AGENTS.md` fájlba, az ismétlődő, lépésekből álló folyamatot pedig egy skillbe tedd. A Hermes Agent skilljei hasonlóan működnek, de más mappákban tárolódnak és másképp telepíthetők. Ezekről külön útmutató szól: [Hermes Agent Skills: Telepítés és létrehozás](https://ailoot.ai/blog/hu/hermes-agent-skills/). Ez a cikk kizárólag a Codexről szól. ## Miből áll egy skill?
Fő tanulság Egy skillnek legalább egy `SKILL.md` fájlja van, amely két kötelező mezőt tartalmaz: `name` és `description`. Opcionálisan `scripts/`, `references/` és `assets/` mappákat, valamint beállításokat tartalmazó `agents/openai.yaml` fájlt is hozzáadhatsz.
Egy skillmappa szerkezete a következő: ``` my-skill/ SKILL.md - kötelező: metaadatok és utasítások scripts/ - opcionális: futtatható kód references/ - opcionális: szükség szerint betöltendő dokumentumok assets/ - opcionális: sablonok és erőforrások agents/ openai.yaml - opcionális: megjelenés és függőségek ``` Maga a `SKILL.md` fájl egy három kötőjel közé tett metaadatblokkal kezdődik, amelyet az utasításszöveg követ Markdown formátumban: ```markdown --- name: weekly-sales-report description: Heti értékesítési jelentés összeállítása CSV-exportból. Akkor használd, ha heti értékesítési jelentést vagy vezetőnkénti összefoglalót kérnek. --- 1. Olvasd be az exportfájlt a felhasználó által megadott útvonalról. 2. Csoportosítsd a sorokat vezetőnként, majd számítsd ki az összeget és az üzletek számát. 3. Hasonlítsd össze az előző héttel, ha az előző heti fájl a közelben van. Ha nincs ott, ezt egyértelműen írd bele a jelentésbe. 4. Mentsd az eredményt a report.md fájlba: vezetőnkénti táblázat, az összeg, valamint legfeljebb három fontos változás számadatokkal, annyi, amennyit az adatok alátámasztanak. ``` Három szabály az OpenAI hivatalos ajánlásai közül: - Egy skill, egy feladat. A „Kezeld az összes marketingemet” helyett válassz konkrét feladatot: „állíts össze értékesítési jelentést ebből az exportból”. Bontsd a nagyobb folyamatot különálló, egymás után meghívható skillekre. - Írd le közvetlenül a lépéseket, egyértelmű bemenetekkel és kimenetekkel: mit kell használni, mit kell tenni, és hová kerüljön az eredmény. - Kezdd szöveges utasításokkal. Akkor használj szkripteket a `scripts/` mappában, ha egy lépést minden alkalommal pontosan ugyanúgy kell végrehajtani—például fájl konvertálásához vagy külső rendszer hívásához. A Codex a `description` mező alapján választ skillt egy feladathoz, ezért a leírást a feladattal és azokkal a szavakkal kezdd, amelyeket általában a feladat leírására használsz. ## Hol keresi a Codex a skilleket?
Fő tanulság A Codex négy helyen keresi a skilleket: a projekt `.agents/skills` mappájában (az aktuális mappától a szülőmappákon át a repository gyökeréig ellenőrizve), a személyes `$HOME/.agents/skills` mappában, a rendszer `/etc/codex/skills` mappájában, valamint az OpenAI beépített skilljei között.
| Szint | Útvonal | Rendeltetés | |----|----|----| | Projekt | `.agents/skills` az aktuális mappában és szülőmappáiban a repository gyökeréig | Egy adott projekthez tartozó skillek, amelyek a kóddal együtt gitben tárolhatók | | Felhasználó | `$HOME/.agents/skills` | Személyes skilljeid, amelyek a gép összes projektjében elérhetők | | Rendszer | `/etc/codex/skills` | A gép vagy konténer összes felhasználójával megosztott skillek | | Beépített | A Codex része | Alapvető OpenAI-skillek, például a skillkészítő | A projekt skilleit praktikus a kóddal együtt gitben tárolni, így az egész csapat ugyanazt a készletet kapja. A személyes skillek jól működnek a saját folyamataidhoz, például az e-mail-stílusodhoz. Ha két különböző szintű skill neve megegyezik, a Codex nem vonja össze őket: mindkettő megjelenik a listában, és nehezebb lesz választani. Adj nekik egyedi nevet. Összehasonlításképpen: a Claude Code skilljei a `.claude/skills` mappában tárolódnak, mindegyik saját `SKILL.md` fájllal rendelkezik, és ugyanazt a nyílt szabványt használják. Egy egyszerű skill átmásolható oda, ezután futtasd, és ellenőrizd, hogy meghívódik-e. A Claude Code-bővítmények összehasonlításához lásd: [Skills, Subagents, MCP vagy Plugins](https://ailoot.ai/blog/hu/skills-subagents-mcp-plugins-claude-code/). ## Hogyan dönti el a Codex, melyik skillt hívja meg?
Fő tanulság Explicit módon is meghívhatsz egy skillt: a Codex CLI-ben vagy IDE-bővítményben írd be a `$skill-name` kifejezést a kérésedbe, vagy válaszd ki a `/skills` paranccsal. Implicit meghívás esetén a Codex automatikusan kiválaszt egy skillt, ha a feladatod illik a leírásához. A skillnek elérhetőnek kell lennie, és az automatikus meghívást engedélyezni kell.
Kezdetben az explicit meghívás megbízhatóbb: a Codex CLI-ben írd be a `$weekly-sales-report` kifejezést az adott folyamat kiválasztásához. Az implicit meghívás kényelmesebb a mindennapi munkához. Miután megírtál egy skillt, teszteld hétköznapi megfogalmazással: kérd meg a Codexet a feladat elvégzésére a saját szavaiddal, `$` nélkül, majd nézd meg, hogy kiválasztja-e a skillt. Ha nem, először ellenőrizd, hogy a Codex látja-e a skillt a `/skills` alatt, a skill valamelyik betöltési mappában van-e, és a skill vagy annak automatikus meghívása nincs-e letiltva. Ha elérhető és a beállítások helyesek, finomítsd a `description` mezőt: írd le a feladatot és a kérés tipikus megfogalmazásait. Ha azt szeretnéd, hogy egy skill csak explicit paranccsal legyen elérhető, ezt is beállíthatod: az `agents/openai.yaml` fájlban az `allow_implicit_invocation: false` paraméter letiltja az automatikus meghívást, a `$name` viszont továbbra is működik. A skill teljesen letiltható törlés nélkül a `~/.codex/config.toml` fájlban: ```toml [[skills.config]] path = "/full/path/to/the/skill/SKILL.md" enabled = false ``` A `config.toml` szerkesztése után indítsd újra a Codexet. A Codex automatikusan észleli a skillmappák módosításait, de ha egy új skill nem jelenik meg, indítsd újra a Codexet. ## Saját skill létrehozása lépésről lépésre
Fő tanulság Válassz ki egy ismétlődő feladatot, hozz létre hozzá egy skillt a beépített `$skill-creator` asszisztenssel vagy manuálisan, írj egyértelműen meghatározott eredményt előíró utasításokat, teszteld a meghívást hétköznapi megfogalmazással, majd minden futtatás után finomítsd a skillt.
1. ### Válassz egy feladatot Válassz ki egy rendszeresen ismételt, egyértelmű eredménnyel járó folyamatot: jelentést, táblázatot, levelet vagy elemzést. Ha még soha nem kaptál ilyen eredményt, először végezd el manuálisan a feladatot egy ügynökkel. A kapott eredményt használd az utasítások mércéjeként. 2. ### Hozz létre egy skillt A beépített asszisztenssel való skillkészítéshez írd be a `$skill-creator` kifejezést egy Codex-munkamenetben. Az asszisztens megkérdezi, mire való a skill, mikor kell meghívni, és szükség van-e szkriptekre, majd összeállítja neked a keretet. A manuális létrehozáshoz készíts egy `.agents/skills` mappát a projektben, benne a skill almappájával, például `.agents/skills/weekly-sales-report`, és helyezz el benne egy `SKILL.md` fájlt a fenti példa alapján. 3. ### Írd meg az utasításokat A lépéseket számozott listában írd le, egyértelmű bemenetekkel és kimenetekkel. Ha a folyamat pontosságot kíván (adatátvitel, átnevezés, számítás), minden lépést részletezz. Kreatív feladatoknál (szövegírás, érvek kiválasztása) határozd meg a korlátokat és a jó eredmény kritériumait, de hagyj mozgásteret a modellnek. 4. ### Teszteld a meghívást Kérd meg a Codexet a feladat elvégzésére a saját szavaiddal, a skill nevének említése nélkül. Ha a megfelelő skillt választja, akkor a leírás megfelelt ennek a megfogalmazásnak. Ezután teszteld az explicit meghívást a `$name` kifejezéssel. Ha a skill nem hívódik meg, ellenőrizd a mappát, hogy megjelenik-e a `/skills` alatt, és nézd meg a fent ismertetett letiltási beállításokat. Ha egy új skill nem jelenik meg a listában, indítsd újra a Codexet. Ha az explicit meghívás működik és az automatikus meghívás engedélyezett, de a Codex nem reagál a saját szavaiddal megfogalmazott kérésre, finomítsd a `description` elejét: először a feladat szerepeljen, utána a tipikus megfogalmazások. Teszteld újra. 5. ### Finomítsd a futtatások után Minden futtatás után nézd át az eredményt, és mondd el az ügynöknek, min kell változtatni a skillben: „Legközelebb adj hozzá egy oszlopot, amely az összefoglaló táblázatban az arányt mutatja.” Kreatív munkához a visszajelzések alapján finomítsd a skillt, ha az első verzió nem azt az eredményt adja, amire szükséged van. Az OpenAI és a közösség kész skilljei a `$skill-installer` segítségével és a skill nevének megadásával telepíthetők. Ha meg szeretnéd osztani a saját skilljeidet másokkal, terjeszd őket pluginokként—ez külön csomagolási módszer, amely személyes használathoz nem szükséges. ## Hogyan ellenőrizd az ügynök eredményét?
Fő tanulság Az elfogadási kritériumokat közvetlenül a skillben add meg: mit kell tartalmaznia az eredménynek, és hogyan kell az ügynöknek ellenőriznie a munkáját az átadás előtt. Ez nem garantálja a helyességet; az eredményt neked is ellenőrizned kell.
Az ellenőrzések lehetnek objektívek vagy szubjektívek. Az objektív ellenőrzések mérhetők: „a jelentés tartalmazza az export mind a 12 vezetőjét”, vagy „a táblázat összege megegyezik a CSV összegével”. Ezeket rögzítsd egyértelmű követelményként. A szubjektív ellenőrzések a minőségre vonatkoznak: „a szöveg úgy hangzik, mintha én írtam volna”, vagy „a következtetések rövidek”. Ezeket is formalizálhatod: mellékelj egy jó részletre példát a skillben, és kérd meg az ügynököt, hogy hasonlítsa össze vele az eredményt. Hasznos technika az ellenőrzési ciklus: az eredmény elkészítése után az ügynök végigmegy egy kritériumlistán, kijavítja, amit talál, és csak ezután mutatja meg neked. Az Anthropicnál létezik egy hasonló, evaluator-optimizer nevű minta: az egyik ügynök elvégzi a munkát, egy külön értékelő átnézi, visszajelzést ad, a folyamat pedig az elfogadásig ismétlődik. Egyetlen skillen belül ez általában egyszerűsített változat—az eredmény utolsó önellenőrzése egy lista alapján. Tartsd észben a korlátját: gyengébb egy független értékelőnél, mert a munkát végző ügynök nem biztos, hogy észreveszi a saját hibáját. Példa egy ellenőrzési blokkra a jelentésünkhöz: ```markdown ## Beküldés előtt ellenőrizd - Az export minden vezetője szerepel a táblázatban; senki nem maradt ki. - Az összeg az utolsó centig megegyezik a CSV összegével. - Minden fontos változást számadat támaszt alá; ha nincs összehasonlítási adat, a jelentés ezt egyértelműen kimondja. - A fájl a report.md útvonalon van elmentve, és az elérési útját megosztottad a felhasználóval. ``` ## Melyik modellt válaszd egy skillhez?
Fő tanulság Kezdd azzal a modellel, amelyen a skill működött, majd próbálj ki olcsóbb modelleket: ha a minőség megmarad, válaszd az olcsóbbat. Az API-díjak és az első futtatások kiindulópontjai alább találhatók, 2026. szeptember 20-i állapot szerint.
| Modell | Bemenet, $/millió token | Kimenet, $/millió token | Milyen feladaton próbáld ki először? | |----|----|----|----| | GPT-6 Astra | 10 | 50 | Hosszabb gondolkodást, képeket és böngészőhasználatot igénylő skillek | | GPT-5.6 Sol | 4 | 20 | Közepes összetettségű szöveges skillek | | GPT-5.6 Terra | 2.50 | 15 | Egyszerű, egyértelmű eredménnyel járó folyamatok | | GPT-5.6 Luna | 0.20 | 1.20 | Mechanikus feladatok: újraformázás, számítás, lista összeállítása | A jobb szélső oszlop kezdeti ellenőrzésekhez ajánl feladatokat. Ez nem rangsor vagy összehasonlítás eredménye: a skillhez megfelelő modellt csak a futtatás és az eredmény patkóként használt referenciával való összevetése után tudod meghatározni. A táblázatban szereplő árak a modelloldalakon közzétett API-díjak 2026. szeptember 20-i állapot szerint, nem a ChatGPT-előfizetés árai. Előfizetés esetén a használat az előfizetés kereteiből történik. Ezen a napon Sol promóciós díja $4/$20 volt, legalább 2026. november 21-ig; a normál ára $5/$30. Nagy, ismétlődő futtatás előtt ellenőrizd az árlistát: az OpenAI promóciói változnak. Futtasd ugyanazt a skillt a következő olcsóbb modellen, és hasonlítsd össze az eredményt a referenciával. Ha a minőség megmarad, próbáld ki a következő, még olcsóbb modellt is. Ha romlik a minőség, térj vissza az előzőhöz. A modelleknek erőfeszítési szintjei is vannak: az Astra low és max között, az 5.6-os család pedig none és max között mozog. Ezeket is ugyanazzal a referenciával teszteld: először válaszd ki a modellt, utána az erőfeszítési szintet. A skill rendszeres futtatása ismétlődő költségeket jelent. Az Astra bemeneti ára az Lunáénak 50-szerese, ezért ugyanazon ismétlődő skill különböző modellekkel való használata észrevehető költségkülönbséget okozhat. Képernyőképeket és dokumentumokat elemző skill esetén a gyengébb modell az utómunka miatt többe kerülhet. ## Gyakori hibák skill készítésekor és használatakor - „Mindenre jó” skill. Egy folyamat, egy skill—ezt ajánlja az OpenAI is. Nehéz egy univerzális, tízoldalas skillt pontosan leírni, a Codex pedig a leírás alapján választ skillt a feladathoz. - Homályos leírás. A „Jelentések készítésében segít” nem teszi világossá, milyen jelentésekhez való a skill. A `description` elején add meg a feladatot és a kérés tipikus megfogalmazásait. - Meghatározott eredmény nélküli utasítások. Ha nem adod meg, mit kell elkészíteni, és hová kell tenni, az eredmény futtatásonként eltérhet. - Semmilyen ellenőrzés. Kritériumokat tartalmazó utolsó lépés nélkül az eredmény befejezetlen vázlat lehet, amelyet neked kell teljes egészében átnézned. - Alapértelmezés szerint a legnagyobb képességű modell. Először ellenőrizd, hogy egy olcsóbb modell el tudja-e végezni a feladatot: futtasd ugyanazt a skillt, és hasonlítsd össze az eredményt a referenciával. Csak akkor válts, ha a minőség megmarad. - Azonos nevek különböző mappákban. A Codex nem vonja össze az azonos nevű skilleket, ami megnehezíti a megfelelő kiválasztását. ## Kezdés és skill átvitele Claude Code-ba
Fő tanulság Válassz ki egy ismétlődő folyamatot, hozz létre hozzá skillt a `$skill-creator` segítségével, teszteld a meghívást a saját megfogalmazásoddal, és adj hozzá egy végső lépést elfogadási kritériumokkal. Néhány futtatás után finomítsd a leírást és az utasításokat a talált hibák alapján.
Ha több ügynökkel dolgozol, átvihetsz egy kizárólag szöveges utasításokat és egy `SKILL.md` fájlt tartalmazó mappát a Claude Code-ba. Ott a skillek a `.claude/skills` mappában tárolódnak, és a `/name` paranccsal hívhatók meg. Az átvitel után ellenőrizd a skillt, ha szkripteket, függőségeket vagy `agents/openai.yaml` fájlt tartalmaz. A Claude Code skillkönyvtáráról szóló útmutatóért lásd: [Claude Code Skills: Saját készlet összeállítása](https://ailoot.ai/blog/hu/claude-code-skills-library/); a Codex és a Claude Code összehasonlításához pedig: [Codex vs Claude Code](https://ailoot.ai/blog/hu/codex-vs-claude-code-choice/).
### Források - [OpenAI Developers: Skillek készítése—Codex-dokumentáció](https://developers.openai.com/codex/skills) - [OpenAI Developers: A Codex áttekintése](https://developers.openai.com/codex/) - [OpenAI Platform: Modellek és API-díjak](https://platform.openai.com/docs/models) - [Agent Skills: Nyílt szabvány és specifikáció](https://agentskills.io) - [Anthropic Docs: Claude bővítése skillekkel](https://docs.claude.com/en/docs/claude-code/skills) - [Anthropic Engineering: Hatékony ügynökök építése](https://www.anthropic.com/engineering/building-effective-agents) - [OpenAI Developers: Pluginok készítése](https://developers.openai.com/plugins/build/plugins)
[Ugrás az Ailootra](https://ailoot.ai/). ## Kérdések és válaszok: Codex Skills: Skill létrehozása ismétlődő feladatokhoz ### Miért működik a kifejezett meghívás, de az automatikus skillválasztás nem? Nézd meg, hogy a skill látható-e a /skills alatt, és engedélyezett-e az implicit meghívás. Ha mindkettő rendben, a leírás a feladattal kezdődjön, és tartalmazza a szokásos szavaidat; ezután ugyanazt a hétköznapi kérést teszteld újra. ### Mit igazoljak egy értékesítésijelentés-skill eredményében? Minden vezető szerepeljen a bemeneti exportból, az összeg egyezzen a forrással, minden állított változást számok támasszanak alá, és a kért jelentésfájl legyen elmentve. Ha az előző időszak hiányzik, ezt jelezze a jelentés. ## Ailoot · A vállalat és projektportfóliója Az Ailoot felhalmozott működési tapasztalatra, széles ügyfélkörre, stabil szolgáltatásra és folyamatos KPI-ellenőrzésre épít. A vállalat és projektportfóliója: ügyfelek milliói; havi értékesítés milliárdos nagyságrendben. Az Ailoot ezt a működési tapasztalatot használja az ügyfelek termékeiben, ágenseiben, alkalmazásaiban és automatizálásaiban elérhető AI-funkciók API-hozzáféréséhez.