Codex Skills: Takroriy vazifalar uchun skill yaratish
MarkdownSKILL.md tuzilishi, yuklash yo‘llari, aniq va avtomatik chaqirish, natija mezonlari hamda skillni Claude Code’ga ko‘chirish.
Maqolani to‘liq o‘qish
Agar Codex’ga haftasiga besh marta bir xil narsani tushuntirsangiz — hisobotni qanday formatlash, elektron xatlarni qanday saralash yoki matnni o‘z uslubingizda qanday tayyorlashni — bu ko‘rsatmalarni bir marta skillga yozib qo‘yishingiz mumkin. Shundan so‘ng agent vazifa tavsifga mos kelganda skillni tavsifi orqali topishi mumkin yoki uni o‘zingiz aniq chaqirishingiz mumkin. Skill — SKILL.md nomli matn fayli bo‘lgan oddiy papka; asosiy foydalanish uchun dasturlash kerak emas.
Quyida skill qanday tuzilgani, Codex uni qayerdan izlashini, uni bosqichma-bosqich qanday yaratishni va narxga qarab modelni qanday tanlashni ko‘rib chiqamiz. Buyruqlar va narxlar 2026-yil 20-sentabr holatiga ko‘ra OpenAI’ning rasmiy hujjatlariga asoslangan. Codex’ni o‘rnatish bo‘yicha ko‘rsatmalarni bu yerda takrorlamaymiz; ular OpenAI Codex: bu nima, qanday o‘rnatish va ishga tushirish qo‘llanmasida berilgan.
Ailoot’dan foydalanish bo‘yicha amaliy ma’lumotlar hujjatlarda mavjud.
Codex’da skill nima?
Asosiy xulosa
Codex skilli — jarayonni tavsiflaydigan papka: nima qilish, nimaga asoslanish va yaxshi natija qanday ko‘rinishi kerak. Codex dastlab kontekstda faqat skill nomlari va tavsiflarini saqlaydi, undan foydalanishga qaror qilganda esa to‘liq ko‘rsatmalarni yuklaydi.
Bu format Agent Skills deb ataladi. U dastlab Anthropic tomonidan ishlab chiqilgan va agentskills.io saytida e’lon qilingan ochiq standartdir. Uni Codex, Claude Code va boshqa mos mijozlarni ham o‘z ichiga olgan turli agentlar qo‘llab-quvvatlaydi. Faqat matnli ko‘rsatmalardan iborat oddiy skillni papkasini nusxalash orqali ular orasida ko‘chirish mumkin. Agar unda skriptlar, bog‘liqliklar yoki agents/openai.yaml fayli bo‘lsa, ko‘chirgandan keyin skillni tekshiring: ayrim sozlamalar muayyan mijozga xos bo‘ladi.
Bu yuklash usuli bosqichma-bosqich ochib berish deb ataladi. Agent skill qachon kerakligini uning nomi va tavsifiga qarab aniqlaydi. Vazifa tavsifga mos kelganda, agent to‘liq SKILL.md faylini o‘qib, unga amal qiladi. Demak, Codex’da o‘nlab skill saqlashingiz mumkin, lekin barcha ko‘rsatmalarni kontekstga birdan yuklash shart emas: dastlabki ro‘yxat kontekst oynasining 2% idan ko‘pini olmaydi (yoki oyna hajmi noma’lum bo‘lsa, 8 000 belgini). Skill’lar ko‘p bo‘lsa, Codex avval ularning tavsiflarini qisqartiradi; juda ko‘p bo‘lsa, ayrimlarini ro‘yxatdan chiqarib tashlashi va bu haqda sizga xabar berishi mumkin.
Skillni AGENTS.md bilan adashtirish oson. Codex har bir loyiha seansida bu faylni o‘qiydi. Unda doimiy qoidalar — texnologiyalar to‘plami, kelishuvlar va kod yozish uslubi — bo‘ladi. Skill esa vazifa unga mos kelganda talab bo‘yicha yuklanadi. Shuning uchun doimiy qoidalarni AGENTS.md fayliga, bosqichlari bor takroriy jarayonni esa skillga yozing.
Hermes Agent skill’lari ham xuddi shunday ishlaydi, ammo boshqa papkalarda saqlanadi va boshqacha o‘rnatiladi. Ular alohida qo‘llanmada yoritilgan: Hermes Agent Skills: o‘rnatish va yaratish. Ushbu maqola faqat Codex haqida.
Skill nimalardan iborat?
Asosiy xulosa
Eng kamida skillda ikkita majburiy maydon — name va description — bo‘lgan bitta SKILL.md fayli bo‘ladi. Ixtiyoriy ravishda scripts/, references/ va assets/ papkalarini, shuningdek sozlamalar yozilgan agents/openai.yaml faylini qo‘shishingiz mumkin.
Skill papkasi quyidagi tuzilishga ega:
my-skill/
SKILL.md - majburiy: metama’lumot va ko‘rsatmalar
scripts/ - ixtiyoriy: bajariladigan kod
references/ - ixtiyoriy: zaruratga qarab yuklanadigan hujjatlar
assets/ - ixtiyoriy: shablonlar va resurslar
agents/
openai.yaml - ixtiyoriy: ko‘rinish va bog‘liqliklar
SKILL.md faylining o‘zi uchta tire orasidagi metama’lumot blokidan boshlanadi, undan keyin Markdown formatidagi ko‘rsatmalar matni keladi:
---
name: weekly-sales-report
description: CSV eksportidan haftalik savdo hisobotini tuzing. Haftalik savdo hisoboti yoki menejerlar bo‘yicha xulosa so‘ralganda foydalaning.
---
1. Foydalanuvchi taqdim etgan yo‘ldagi eksport faylini o‘qing.
2. Qatorlarni menejer bo‘yicha guruhlang va bitimlarning jami summasi hamda sonini hisoblang.
3. Agar oldingi hafta uchun fayl yaqin joyda bo‘lsa, natijani u bilan taqqoslang. Agar u yerda bo‘lmasa, hisobotda buni ochiq ayting.
4. Natijani report.md fayliga saqlang: menejerlar bo‘yicha jadval, jami summa va ma’lumotlar imkon berganicha raqamlar bilan ko‘pi bilan uchta asosiy o‘zgarish.
OpenAI’ning rasmiy tavsiyalaridan uchta qoida:
- Bitta skill — bitta vazifa. “Barcha marketing ishlarimni bajaring” deyish o‘rniga, “ushbu eksportdan savdo hisobotini tuzing” kabi aniq vazifani tanlang. Katta jarayonni ketma-ket chaqiriladigan alohida skill’larga ajrating.
- Bosqichlarni to‘g‘ridan-to‘g‘ri, kirish va chiqish ma’lumotlarini aniq ko‘rsatib yozing: nimadan foydalanish, nima qilish va natijani qayerga joylash.
- Matnli ko‘rsatmalardan boshlang. Biror bosqich har safar aynan bir xil bajarilishi shart bo‘lsa — masalan, faylni o‘zgartirish yoki tashqi tizimga murojaat qilish —
scripts/ichidagi skriptlardan foydalaning.
Codex vazifa uchun skillni description maydoniga qarab tanlaydi, shuning uchun tavsifni vazifa nomi va uni odatda qanday so‘zlar bilan ifodalashingizdan boshlang.
Codex skill’larni qayerdan izlaydi?
Asosiy xulosa
Codex skill’larni to‘rt darajada izlaydi: loyiha ichidagi .agents/skills papkasida (joriy papka va ombor ildizigacha bo‘lgan har bir ota papkani tekshiradi), shaxsiy $HOME/.agents/skills papkasida, tizimdagi /etc/codex/skills papkasida va OpenAI’ning ichki o‘rnatilgan skill’lari orasida.
| Daraja | Yo‘l | Maqsadi |
|---|---|---|
| Loyiha | Joriy papka va undan ota papkalar bo‘ylab ombor ildizigacha bo‘lgan .agents/skills | Muayyan loyiha uchun skill’lar; ularni kod bilan birga git’da saqlash mumkin |
| Foydalanuvchi | $HOME/.agents/skills | Mashinadagi barcha loyihalarda mavjud shaxsiy skill’laringiz |
| Tizim | /etc/codex/skills | Mashina yoki konteynerning barcha foydalanuvchilari uchun umumiy skill’lar |
| Ichki | Codex bilan birga o‘rnatilgan | OpenAI’ning skill yaratuvchisi kabi asosiy skill’lari |
Loyiha skill’larini kod bilan birga git’da saqlash qulay, shunda butun jamoa bir xil to‘plamdan foydalanadi. Shaxsiy skill’lar elektron xat yozish uslubingiz kabi o‘zingizga xos jarayonlar uchun mos. Turli darajadagi ikkita skill bir xil nomga ega bo‘lsa, Codex ularni birlashtirmaydi: ikkalasi ham ro‘yxatda ko‘rinib, tanlashni qiyinlashtiradi. Nomlarni noyob qiling.
Taqqoslash uchun, Claude Code skill’lari .claude/skills ichida saqlanadi va har birida o‘zining SKILL.md fayli bo‘ladi; ular ham shu ochiq standartdan foydalanadi. Oddiy skillni papkasini nusxalash orqali u yerga ko‘chirish mumkin, shundan keyin uni ishga tushirib, chaqirilishini tekshiring. Claude Code kengaytmalari taqqoslanishi uchun Skills, Subagents, MCP yoki Plugins maqolasini ko‘ring.
Codex qaysi skillni chaqirishni qanday hal qiladi?
Asosiy xulosa
Skillni aniq chaqirishingiz mumkin: Codex CLI yoki IDE kengaytmasida so‘rovingizga $skill-name kiriting yoki /skills orqali tanlang. Bilvosita chaqirishda esa vazifangiz tavsifga mos kelsa, Codex skillni avtomatik tanlaydi. Skill mavjud bo‘lishi va avtomatik chaqirishga ruxsat berilgan bo‘lishi kerak.
Dastlab aniq chaqirish ishonchliroq: Codex CLI’da aynan shu jarayonni tanlash uchun $weekly-sales-report kiriting. Bilvosita chaqirish kundalik ishda qulayroq. Skill yozgandan keyin uni odatiy so‘zlar bilan sinab ko‘ring: Codex’dan vazifani o‘z so‘zlaringiz bilan, $ belgisiz bajarishni so‘rang va u skillni tanlaydimi, tekshiring. Tanlamasa, avval Codex skillni /skills orqali ko‘ra olishini, skill yuklanadigan papkalardan birida ekanini, skillning o‘zi yoki avtomatik chaqirilishi o‘chirilmaganini tekshiring. Skill mavjud va sozlamalar to‘g‘ri bo‘lsa, description maydonini aniqlashtiring: vazifa va so‘rovni odatda qanday ifodalashingizni yozing.
Agar skill faqat aniq buyruq orqali mavjud bo‘lishini istasangiz, buni ham sozlashingiz mumkin: agents/openai.yaml faylidagi allow_implicit_invocation: false parametri avtomatik chaqirishni o‘chiradi, $name esa ishlashda davom etadi. Skillni o‘chirmasdan butunlay o‘chirib qo‘yish uchun ~/.codex/config.toml faylidan foydalaning:
[[skills.config]]
path = "/full/path/to/the/skill/SKILL.md"
enabled = false
config.toml faylini tahrirlagandan so‘ng Codex’ni qayta ishga tushiring. Codex skill papkalaridagi o‘zgarishlarni avtomatik aniqlaydi, ammo yangi skill ko‘rinmasa, Codex’ni qayta ishga tushiring.
O‘z skill’ingizni bosqichma-bosqich qanday yaratish mumkin?
Asosiy xulosa
Bitta takroriy vazifani tanlang, ichki $skill-creator yordamchisi bilan yoki qo‘lda skill yarating, natijasi aniq ko‘rsatilgan ko‘rsatmalar yozing, uni odatiy so‘zlar bilan chaqirishni sinang va har bir ishga tushirishdan keyin skillni takomillashtiring.
Bitta vazifani tanlang
Aniq natijasi bo‘lgan, muntazam takrorlaydigan jarayonni tanlang: hisobot, jadval, xat yoki tahlil. Agar bunday natijani hali olmagan bo‘lsangiz, avval agent bilan vazifani qo‘lda bajaring. Ko‘rsatmalar uchun mezon sifatida olingan natijadan foydalaning.
Skill yarating
Ichki yordamchi bilan skill yaratish uchun Codex seansida
$skill-creatorkiriting. U skill nima qilishini, qachon chaqirilishi kerakligini va skriptlar kerak yoki kerak emasligini so‘raydi, keyin esa asosini siz uchun tayyorlaydi. Qo‘lda yaratish uchun loyihada.agents/skillspapkasini, uning ichida skill nomli ichki papkani, masalan.agents/skills/weekly-sales-reportni yarating va yuqoridagi misoldan foydalanib ichigaSKILL.mdfaylini joylang.Ko‘rsatmalarni yozing
Bosqichlarni aniq kirish va chiqish ma’lumotlari bilan raqamlangan ro‘yxat tarzida yozing. Jarayon aniqlikni talab qilsa (ma’lumot uzatish, nomini o‘zgartirish, hisoblash), har bir bosqichni batafsil ko‘rsating. Ijodiy vazifalarda (matn yozish, dalillarni tanlash) yaxshi natija uchun chegaralar va mezonlarni belgilang, lekin modelga ishlash uchun imkon qoldiring.
Chaqirishni sinang
Codex’dan skill nomini aytmasdan, vazifani o‘z so‘zlaringiz bilan bajarishni so‘rang. To‘g‘ri skillni tanlasa, shu ifoda uchun tavsif ish berdi. Keyin
$namebilan aniq chaqirishni sinang. Skill chaqirilmasa, papkani, uning/skillsichida ko‘rinishini va yuqorida bayon qilingan o‘chirish sozlamalarini tekshiring. Yangi skill ro‘yxatda ko‘rinmasa, Codex’ni qayta ishga tushiring. Aniq chaqirish ishlasa va avtomatik chaqirishga ruxsat berilgan bo‘lsa-yu, Codex so‘rovingizni o‘z so‘zlaringiz bilan berganingizda javob bermasa,descriptionmaydonining bosh qismini aniqlashtiring: avval vazifani, keyin so‘rovni odatda qanday ifodalashingizni yozing. Yana sinab ko‘ring.Ishga tushirishlardan keyin takomillashtiring
Har bir ishga tushirishdan keyin natijani ko‘rib chiqing va agentga skillda nimani o‘zgartirish kerakligini ayting: “Keyingi safar xulosa jadvaliga ulushni ko‘rsatadigan ustun qo‘shing.” Birinchi versiya kerakli natijani bermasa, ijodiy ishlar uchun skillni fikr-mulohazaga qarab takomillashtiring.
OpenAI va hamjamiyat tayyorlagan skill’lar $skill-installer va skill nomi yordamida o‘rnatiladi. O‘z skill’ingizni boshqalar bilan ulashish uchun uni plugin sifatida tarqating — bu shaxsiy foydalanish uchun zarur bo‘lmagan alohida qadoqlash usuli.
Agent natijasini qanday tekshirish mumkin?
Asosiy xulosa
Qabul qilish mezonlarini to‘g‘ridan-to‘g‘ri skillga kiriting: natijada nimalar bo‘lishi va agent ishni topshirishdan oldin uni qanday tekshirishi kerak. Bu to‘g‘riligiga kafolat bermaydi; natijani baribir o‘zingiz tekshirishingiz kerak.
Tekshiruvlar obyektiv yoki subyektiv bo‘lishi mumkin. Obyektiv tekshiruvlarni o‘lchash mumkin: “hisobotda eksportdagi 12 menejerning barchasi bor” yoki “jadvaldagi yig‘indi CSV jami summasiga teng”. Bularni qat’iy talablar sifatida yozing. Subyektiv tekshiruvlar sifatga tegishli: “matn men yozgandek o‘qiladi” yoki “xulosalar qisqa”. Bularni ham rasmiylashtirishingiz mumkin: skillga yaxshi parcha namunasini kiriting va agentdan natijasini shu namuna bilan taqqoslashni so‘rang.
Foydali usullardan biri — ko‘rib chiqish sikli: natijani tayyorlagandan so‘ng agent mezonlar ro‘yxatini tekshiradi, topgan kamchiliklarini tuzatadi va shundan keyingina uni sizga ko‘rsatadi. Anthropic’da evaluator-optimizer deb ataladigan shunga o‘xshash usul bor: bitta agent ishni bajaradi, boshqa evaluator uni tekshirib fikr-mulohaza qaytaradi, so‘ng qabul qilinmaguncha jarayon takrorlanadi. Bitta skill ichida bu odatda soddalashtirilgan ko‘rinishda — ro‘yxat bo‘yicha yakuniy o‘zini tekshirish tarzida bo‘ladi. Uning cheklovini yodda tuting: bu mustaqil evaluatordan kuchsizroq, chunki ishni bajargan agent o‘z xatosini payqamasligi mumkin.
Hisobotimiz uchun tekshiruv bloki namunasi:
## Topshirishdan oldin tekshiring
- Eksportdagi har bir menejer jadvalda bor; hech kim tushib qolmagan.
- Jami summa CSV yig‘indisiga oxirgi sentigacha mos keladi.
- Har bir asosiy o‘zgarish raqam bilan tasdiqlangan; taqqoslash uchun ma’lumot bo‘lmasa, hisobotda bu ochiq aytilgan.
- Fayl report.md manziliga saqlangan va yo‘l foydalanuvchi bilan ulashilgan.
Skill uchun qaysi modelni tanlash kerak?
Asosiy xulosa
Avval skill ishlagan modeldan boshlang, keyin arzonroq modellarni sinab ko‘ring: sifat saqlansa, arzoni bilan qoling. API tariflari va dastlabki ishga tushirishlar uchun tavsiyalar quyida berilgan — 2026-yil 20-sentabr holatiga ko‘ra.
| Model | Kirish, $/million token | Chiqish, $/million token | Avval nimada sinab ko‘rish kerak |
|---|---|---|---|
| GPT-6 Astra | 10 | 50 | Kengaytirilgan mulohaza, tasvirlar va brauzerdan foydalanishni o‘z ichiga olgan skill’lar |
| GPT-5.6 Sol | 4 | 20 | O‘rtacha murakkablikdagi matnli skill’lar |
| GPT-5.6 Terra | 2.50 | 15 | Natijasi aniq bo‘lgan oddiy jarayonlar |
| GPT-5.6 Luna | 0.20 | 1.20 | Mexanik vazifalar: formatlash, hisoblash, ro‘yxat tuzish |
Eng o‘ngdagi ustunda dastlabki tekshiruvlar uchun mos vazifalar ko‘rsatilgan. Bu reyting yoki taqqoslash natijasi emas: skill’ingiz uchun mos modelni faqat uni ishga tushirib, mezon natijasi bilan taqqoslaganingizdan keyingina aniqlashingiz mumkin.
Jadvaldagi narxlar ChatGPT obunasi narxlari emas, balki 2026-yil 20-sentabr holatidagi model sahifalarida keltirilgan API tariflaridir. Obunadan foydalanganda sarf uning limitlari doirasida bo‘ladi. Shu sanada Sol uchun 4/20 dollarlik reklama tarifi kamida 2026-yil 21-noyabrgacha amal qiladi; standart narxi 5/30 dollar. Katta takroriy ishga tushirishdan oldin narxlar sahifasini tekshiring: OpenAI aksiyalari o‘zgarib turadi.
Xuddi shu skillni keyingi arzonroq modelda ishga tushiring va natijani mezon bilan taqqoslang. Sifat saqlansa, undan ham arzonroq keyingi modelni sinab ko‘ring. Sifat pasaysa, avvalgi modelga qayting. Modellarda kuch darajalari ham bor: Astra’da low’dan max’gacha, 5.6 oilasida esa none’dan max’gacha. Ularni ham shu mezon bilan sinang: avval modelni, keyin kuch darajasini tanlang.
Skillni muntazam ishga tushirish takroriy xarajatlarni keltirib chiqaradi. Astra’ning kirish narxi Luna’niki bilan solishtirganda 50 baravar yuqori, shuning uchun bir xil takroriy skill uchun turli modellardan foydalanish xarajatlarda sezilarli farq keltirib chiqarishi mumkin. Skrinshotlar va hujjatlarni tahlil qiladigan skill uchun kuchsizroq model qayta ishlash sababli qimmatroqqa tushishi mumkin.
Skill yaratish va undan foydalanishdagi keng tarqalgan xatolar
- “Hammasi uchun” mo‘ljallangan skill. Bitta jarayon, bitta skill — bu ham OpenAI tavsiyasi. O‘n sahifali universal skillni aniq tavsiflash qiyin, Codex esa vazifa uchun skillni uning tavsifiga qarab tanlaydi.
- Noaniq tavsif. “Hisobotlarda yordam beradi” degani skill qanday turdagi hisobotlar uchun ekanini bildirmaydi. Vazifa va so‘rovni odatda qanday ifodalashingizni
descriptionmaydonining boshida yozing. - Natijasi belgilanmagan ko‘rsatmalar. Nima tayyorlanishi va qayerga joylanishini ko‘rsatmasangiz, natijalar har ishga tushirishda farq qilishi mumkin.
- Umuman tekshiruv yo‘qligi. Mezonlari bo‘lgan yakuniy bosqichsiz natija tugallanmagan qoralama bo‘lib qolishi va uni o‘zingiz to‘liq ko‘rib chiqishingizga to‘g‘ri kelishi mumkin.
- Sukut bo‘yicha eng kuchli modeldan foydalanish. Avval arzonroq model vazifani bajara oladimi, tekshiring: shu skillni ishga tushirib, natijani mezon bilan taqqoslang. Faqat sifat saqlansa o‘ting.
- Turli papkalarda bir xil nomlar. Codex bir xil nomli skill’larni birlashtirmaydi, bu esa keraklisini tanlashni qiyinlashtiradi.
Boshlash va skillni Claude Code’ga ko‘chirish
Asosiy xulosa
Bitta takroriy jarayonni tanlang, $skill-creator bilan skill yarating, uni o‘z so‘zlaringiz bilan chaqirishni sinang va qabul qilish mezonlari keltirilgan yakuniy bosqichni qo‘shing. Bir necha marta ishlatgandan so‘ng, topilgan xatolarga qarab tavsif va ko‘rsatmalarni takomillashtiring.
Bir nechta agent bilan ishlasangiz, faqat matnli ko‘rsatmalar va SKILL.md faylidan iborat papkani Claude Code’ga ko‘chirishingiz mumkin. U yerda skill’lar .claude/skills ichida saqlanadi va /name bilan chaqiriladi. Skillda skriptlar, bog‘liqliklar yoki agents/openai.yaml bo‘lsa, ko‘chirgandan keyin uni tekshiring. Claude Code skill’lari to‘plami bo‘yicha qo‘llanma uchun Claude Code Skills: o‘z to‘plamingizni qanday yaratish kerak maqolasini, Codex va Claude Code taqqoslanishi uchun esa Codex va Claude Code maqolasini ko‘ring.
Manbalar
- OpenAI Developers: Skill yaratish — Codex hujjatlari
- OpenAI Developers: Codex haqida umumiy ma’lumot
- OpenAI Platform: Modellar va API tariflari
- Agent Skills: Ochiq standart va spetsifikatsiya
- Anthropic Docs: Claude’ni skill’lar bilan kengaytirish
- Anthropic Engineering: Samarali agentlar yaratish
- OpenAI Developers: Plugin’lar yaratish
Batafsil
Ko‘p beriladigan savollar
Nega skill’ni aniq chaqirish ishlaydi-yu, avtomatik tanlash ishlamaydi?
Skill /skills da ko‘rinishini va bilvosita chaqirish yoqilganini tekshiring. Ikkalasi to‘g‘ri bo‘lsa, description’ni vazifadan boshlang va odatda ishlatadigan so‘zlaringizni kiriting. So‘ng o‘sha oddiy so‘rovni yana sinang.
Savdo hisobotini tayyorlaydigan skill natijasida nimani tekshiraman?
Eksportdagi har bir menejer ko‘rsatilganini, jami manbaga mosligini, o‘zgarish haqidagi har bir fikr raqam bilan asoslanganini va kerakli hisobot fayli saqlanganini tekshiring. Oldingi davr bo‘lmasa, hisobot buni aytishi kerak.