Codex Skills: Skill létrehozása ismétlődő feladatokhoz

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ó útmutatóban találhatók.

Az Ailoot használatával kapcsolatos gyakorlati tudnivalók a dokumentációban találhatók.

Mi az a skill a Codexben?#

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. Ez a cikk kizárólag a Codexről szól.

Miből áll egy skill?#

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:

---
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?#

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.

Hogyan dönti el a Codex, melyik skillt hívja meg?#

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:

[[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#

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?#

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:

## 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?#

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#

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; a Codex és a Claude Code összehasonlításához pedig: Codex vs Claude Code.

Ugrás az Ailootra.