Írj egy újrahasználható készséget
Ezen az oldalon
Ha egy GPT utasításai a szíve, akkor a készség (skill) egy bővítmény szíve. Ez az a formátum, amelyet egy újrahasználható munkafolyamat – utasítások, források és szükség esetén szkriptek – leírására használsz. Az OpenAI készségek egy nyílt szabványt követnek, az „agent skills“ (agentskills.io) néven ismertet, ami azt jelenti, hogy egy jól megírt készség nincs egyetlen eszközhöz kötve. Ebben a leckében megtanulod, hogyan írj ilyet.
Egy készség felépítése
Egy készség egy mappa, amely egy kötelező fájlt, a SKILL.md-t, valamint opcionális elemeket tartalmaz.
synthese-document/
├── SKILL.md ← kötelező: utasítások + metaadatok
├── scripts/ ← opcionális: végrehajtható kód
├── references/ ← opcionális: dokumentáció
├── assets/ ← opcionális: sablonok, források
└── agents/
└── openai.yaml ← opcionális: megjelenés és függőségek
A SKILL.md fájlnak tartalmaznia kell egy name (név) és egy description (leírás) mezőt. Íme egy minimális példa:
---
name: synthese-document
description: Summarizes a provided document into three parts (overview, key points, open questions). Use when the user requests a summary or report of an attached document.
---
# Document Summary
1. Read the entire document before writing.
2. Write three sections: Overview (3 sentences), Key Points (max 5 bullets), Open Questions.
3. Rely only on the document; if information is missing, write "not provided."
4. Use the template in `assets/modele.md` for formatting.
A leírás a középpontban áll
A ChatGPT és a Codex kétféleképpen aktivál egy készséget. Vagy te hívod meg explicit módon – a ChatGPT-ben a @ karakter begépelésével, illetve a Codexben a /skills és $ parancsokkal –, vagy az eszköz automatikusan kiválasztja azt, amikor a kérésed illeszkedik a leírásához. Ezért hangsúlyozza a dokumentáció ezt a mezőt: egy tömör leírásra van szükséged, amely a fő felhasználási esettel és a trigger kulcsszavakkal kezdődik, és egyértelműen meghatározza a korlátait.
Egy speciális mechanizmus áll e követelmény hátterében: a progresszív feltárás (progressive disclosure). Kezdetben a ChatGPT és a Codex csak az egyes telepített készségek nevét és leírását olvassa be; a SKILL.md teljes utasításait csak akkor tölti be, amikor ténylegesen használja is a készséget. Ez lehetővé teszi, hogy sok készséget telepíts anélkül, hogy eldugítanád a kontextust, de azt is jelenti, hogy egy homályos leírás olyan készséghez vezet, amelyet либо sosem választanak ki a megfelelő időben, либо rossz időben aktiválódik.
Opcionális beállítások
Az agents/openai.yaml fájl lehetővé teszi, hogy finomhangold a megjelenítést az asztali alkalmazásban (név, rövid leírás, ikonok, szín, alapértelmezett prompt), deklaráljad a készség függőségeit – például egy MCP szervert –, és beállítsd a meghívási politikát. Az allow_implicit_invocation: false beállítás megakadályozza, hogy a ChatGPT automatikusan válassza ki a készséget: ez érzékeny munkafolyamatoknál hasznos, amelyeket csak kifejezett kérésre szeretnél elindítani.
Hol élnek a készségek, és hogyan oszd meg őket
Egy önálló készség működik a ChatGPT asztali alkalmazásban, a Codexben a parancssoron keresztül, valamint annak szerkesztőbővítményében; a Codexben a projektkészségek a tároló .agents/skills mappájába kerülnek. Ahhoz, hogy egy készséget mások számára is elérhetővé tegyél, az OpenAI azt javasolja, hogy csomagold be egy bővítménybe (plugin): egy bővítmény több készséget is összefoghat, és kapcsolódási pontokat adhat hozzá MCP szerverekhez vagy megjelenítési elemekhez. A bővítménybe foglalt készségek ezután elérhetővé válnak a Chat és Work módokban a ChatGPT-ben, weben, asztali gépen és mobilon is. A webes ChatGPT-ben a bővítménykönyvtár Skills (Készségek) füle lehetővé teszi egy készség létrehozását beszélgetés útján (a beépített skill-creator készség használatával), szerkesztővel vagy importálással, valamint megosztását a munkaterületen belül; ez a fül csak a jogosult Business, Enterprise, Healthcare és Edu előfizetések számára elérhető.
Rajtad a sor
GPT-től a készségig. Vedd át a 4–7. leckében elkészített GPT utasításait. Alakítsd át őket egy SKILL.md fájllá: egy rövid név, egy leírás, amely megadja, mikor és mikor ne használd, számozott lépések, valamint a tudásfájljaid a references/ mappában tárolva. Ezután teszteld a készséget kétszer: egyszer a @ jellel történő meghívással, egyszer pedig egy olyan szokványos kéréssel, amelynek ki kellene váltania azt.
Hivatalos források: Build skills (ChatGPT dokumentáció: SKILL.md, leírás, elhelyezkedés) · Skills in ChatGPT (OpenAI Súgóközpont: Skills fül, csomagtervek, megosztás)
Főbb megállapítások
- Egy készség egy mappa, amely egy
SKILL.mdfájlt (kötelező név + leírás) és opcionális forrásokat tartalmaz; követi a nyílt agent skills szabványt - A leírás dönti el, mikor választják ki a készséget: kezdd a felhasználási esettel, a trigger kulcsszavakkal és a korlátokkal
- Progresszív feltárás: először csak a nevet és a leírást olvassa be a rendszer; az utasítások használatkor töltődnek be
- Egy készség megosztásához csomagold be egy bővítménybe
Teszteld a tudásod
A GPT-ktől a bővítményekig: validáld a teljes utat.
1. Egyéni utasítások, Memória, GPT: mi a különbség?
Válasz: Az Egyéni utasítások (Custom Instructions) minden beszélgetésedet színezik; a Memória idővel megőrzi a rólad szóló tényeket; a GPT egy csomagolt asszisztens – utasításokkal, tudással, eszközökkel –, amelyet megoszthatsz másokkal.
2. Mit tartalmaz egy jó GPT rendszerutasítás?
Válasz: A szerepet, a hatókört (mit csinál és mit nem), a hangnemet, a válaszformátumot és a szélsőséges esetek kezelését – úgy megírva, mint egy állásleírást, nem pedig mint egy kívánságlistát.
3. Mire való a Tudásbázis?
Válasz: Arra, hogy referencia-dokumentumokat biztosítson a GPT számára, amelyeket konzultálva válaszol – a te útmutatóid, katalógusaid vagy eljárásrendjeid –, ahelyett, hogy kizárólag a tanítási memóriájára támaszkodna.
4. Mi történik egy GPT műveleteivel (actions) bővítményre való átálláskor?
Válasz: Nem kerülnek át: ellenőrizned kell, hogy létezik-e már alkalmazás a bővítménykönyvtárban, ellenkező esetben újra kell építened az integrációt, például egy MCP szerverrel. Az utasítások készséggé, a tudásbázis pedig referenciafájlokká válik.
5. Mit ellenőrzöl egy GPT vagy bővítmény megosztása előtt?
Válasz: A valós és szélsőséges eseteken végzett teszteket, a házirendnek való megfelelést, a leírás egyértelműségét, minden nyilvános művelethez tartozó adatvédelmi nyilatkozatot, valamint azt, hogy nem rejtőzik-e érzékeny adat az utasításokban vagy fájlokban.
Egy megosztott eszköz elkötelezi a készítőjét: úgy tesztelj, mintha a felhasználóid már ott lennének, és migráld a GPT-idet 2026. december 11. előtt.