Blog

Claude Code Skills 2026-yilda: o‘zingiz uchun Skills kutubxonasini qanday yaratish mumkin

Markdown

Claude Code Skills yaratish: SKILL.md tuzilishi, description formulasi, Anthropic’dan tayyor to‘plamlar va anti-patternlar. 30 daqiqada bosqichma-bosqich.

Maqolani to‘liq o‘qish

Asosiy xulosalar

Claude Code Skills — bu Claude faqat kerak bo‘lganda kontekstga yuklaydigan SKILL.md faylini o‘z ichiga olgan papkalar. CLAUDE.md doimo xotirada qoladi va token budjetini sarflaydi, skill esa faqat trigger bo‘lganda yuklanadi — bitta loyihada o‘nlab skill bemalol birga ishlashi mumkin. Skillning eng muhim qismi uning description’i: Claude skillni faollashtirish kerakmi, shuni shu tavsifga qarab hal qiladi. Ushbu maqolada SKILL.md tuzilishi, description formulasi, tayyor to‘plamlar va birinchi skillni 30 daqiqada yaratish yo‘lini tushuntiraman.

Ailoot hujjatlari: API, kalitlar va sozlash.

Claude Code’da Skill nima va nega u shunchaki “kattaroq prompt” emas?

Asosiy xulosalar

Skill — muayyan metodologiyani qachon va qanday qo‘llashni tushuntiradigan SKILL.md faylini o‘z ichiga olgan katalog. Anthropic skillni yangi xodim uchun ko‘rsatmalarga qiyoslaydi: har kuni har bir qadamni aytib turmaysiz; unga tartibni berasiz, u esa kerakli vaziyatda o‘zi qo‘llaydi. CLAUDE.md’dan asosiy farqi shundaki, skill kontekstga faqat kerak bo‘lganda yuklanadi. Shu sababli token budjetidan oshib ketmasdan loyihada o‘nlab skill saqlash mumkin.

Claude Code Skills — Anthropic 2025-yil oktabrda Pro/Max/Team/Enterprise uchun ishga tushirgan Claude Code’ning mahalliy funksiyasi. Keyinroq ular Agent Skills spetsifikatsiyasini Claude’dan tashqarida ham ishlaydigan standart sifatida ochdilar. Kodda bu shunchaki papka:

.claude/skills/
├── deploy-to-prod/
│   ├── SKILL.md
│   └── scripts/
│       └── check-migrations.sh
├── weekly-content-plan/
│   └── SKILL.md
└── triage-support-tickets/
    └── SKILL.md

Har bir papka — bitta skill. SKILL.md fayli yuqorisida YAML frontmatter, pastida esa oddiy ko‘rsatmalar bo‘lgan Markdown faylidir. Foydalanuvchi “production’ga deploy qilaylik” desa, Claude deploy-to-prod skillining description’ini ko‘radi, “production’ga deploy qilish” triggerini taniydi, SKILL.md matnini kontekstga yuklaydi va undagi qadamlarni bajaradi.

Bosqichma-bosqich yuklashning uch darajasi

Anthropic skilllarni bosqichma-bosqich yuklash asosida yaratdi: ma’lumotlar kerak bo‘lgani sari qatlamlar bo‘yicha yuklanadi. Anthropic Engineering blogida jamoa buni “Agent Skills’ni moslashuvchan va kengaytiriladigan qiladigan asosiy dizayn tamoyili” deb ta’riflaydi (Anthropic Engineering).

Yuklashning uch darajasi:

  1. Metadata (doimo) - sessiya boshlanganda Claude har bir skillning faqat name va description maydonlarini ko‘radi. Budjet: har bir skill uchun taxminan 100 token.
  2. Ko‘rsatmalar (trigger bo‘lganda) - foydalanuvchi tegishli narsani aytganda, Claude SKILL.md matnini yuklaydi. Budjet: 5000 tokendan kam.
  3. Resurslar (so‘rov bo‘yicha) - birga keladigan fayllar (misollar, shablonlar, ma’lumotlar to‘plamlari) faqat modelning o‘zi ularni izlaganda olinadi. Budjet: cheklanmagan.

Ilgari AI “eslab qolishi” kerak bo‘lgan hamma narsa CLAUDE.md faylida turishi kerak edi — 50 ta qoidali loyiha esa kontekst limitiga tez yetib borardi. Skills yordamida bitta loyihada o‘nlab skill bemalol birga ishlaydi, chunki dastlabki kontekstga faqat ularning description’lari kiradi.

Skills qayerda joylashadi: to‘rt daraja

DarajaYo‘lQamrovi
EnterpriseTashkilot boshqariladigan sozlamalariKompaniyaning barcha foydalanuvchilari
Personal~/.claude/skills/<name>/SKILL.mdBarcha loyihalaringiz
Project.claude/skills/<name>/SKILL.mdFaqat shu loyiha
Plugin<plugin>/skills/<name>/SKILL.mdPlugin yoqilgan joylar

Ustuvorlik: enterprise personal sozlamalarni, personal esa project sozlamalarini bosib ketadi. Pluginlar plugin-name:skill-name namespace’idan foydalanadi va to‘qnashuvga sabab bo‘lmaydi. Bu qulay: umumiy kasbiy skilllarni ~/.claude/skills/ ichiga, loyihaga xoslarini esa repozitoriyning .claude/skills/ ichiga joylashtiring.

SKILL.md ichida nimalar bor?

Asosiy xulosalar

SKILL.md — yuqorisida YAML frontmatter, pastida esa ko‘rsatmalar matni bo‘lgan Markdown fayli. Eng kamida unda ikkita maydon bo‘ladi: name (64 belgigacha) va description (1024 belgigacha). To‘liq sxemada allowed-tools, disable-model-invocation, paths, context: fork, agent va hooks ham bor. Anthropic ko‘rsatmalar matnini 500 qator ichida saqlashni, qolgan narsalarni esa yonidagi ma’lumotnoma fayllariga joylashtirishni tavsiya qiladi.

Mana minimal misol — yigirma qator, skill tayyor:

---
name: weekly-content-plan
description: Telegram kanali va qisqa videolar uchun haftalik post rejasini tayyorlaydi. Triggerlar - "post rejasini tuz", "bu hafta nima joylay?", "kanal uchun 7 kunlik reja". So‘rov veb-sayt yoki email xabarnomasi haqida bo‘lsa, faollashtirmang.
---

# Weekly Content Plan

## Steps

1. `knowledge/audience.md` faylini o‘qing - kimlar uchun yozyapmiz
2. `knowledge/tone-of-voice.md` faylini o‘qing - qanday yozamiz
3. Kanaldagi oxirgi 10 ta postni o‘qing - nimalar allaqachon yoritilgan
4. Haftaga 7 ta mavzu toping: 3 tasi savdoga yo‘naltirilgan, 2 tasi ekspertlik, 2 tasi shaxsiy
5. Har biri uchun bitta ilgak jumla va post haqida uchta punkt bering
6. Natijani jadval ko‘rinishida chiqaring: hafta kuni | tur | ilgak | reja

Shuning o‘zi kifoya. Foydalanuvchi “haftaga postlarni rejalashtiraylik” deb yozsa, Claude description’dagi triggerni ko‘radi, SKILL.md’ni yuklaydi, nomlangan fayllarni o‘qiydi va jadval chiqaradi.

Yodda tutish kerak bo‘lgan cheklovlar

Claude API’ning rasmiy hujjatlari qat’iy cheklovlarni belgilaydi:

  • name: 64 belgigacha; faqat kichik harflar, raqamlar va defislar, XML teglarsiz. anthropic va claude band qilingan.
  • description: API’da 1024 belgigacha; majburiy, XML teglarsiz.
  • Ro‘yxat budjeti: Claude Code’da barcha skilllarning description’lari jami kontekst oynasining taxminan 1% ini egallaydi. Skill ko‘p bo‘lsa, description’lar qisqartiriladi va Claude moslashtirishi kerak bo‘lgan kalit so‘zlar yo‘qolib qolishi mumkin.
  • SKILL.md matni: Anthropic matnni 500 qator ichida saqlashni tavsiya qiladi. Uzunroq narsalarni references/, scripts/ va examples/ fayllariga ko‘chiring va ko‘rsatmalar orqali yuklang.

Kontekst ixchamlangandan (/compact) keyin Claude avval chaqirilgan har bir skillning dastlabki 5000 tokenini saqlab qoladi; qayta biriktiriladigan barcha skilllar uchun umumiy budjet 25 000 token. Skill sig‘masa, uning xatti-harakati “unutiladi”.

Frontmatter’ning to‘liq sxemasi

Eng kamida name va description dan foydalaning. Ishlab chiqarishdagi skilllarda boshqa maydonlar ham ishlatiladi:

MaydonMaqsadMisol
nameSkill nomi; ko‘rsatilmasa, papka nomi ishlatiladideploy-to-prod
descriptionAvtomatik chaqirish triggeriQuyidagi formulaga qarang
when_to_useQo‘shimcha trigger iboralari["deploy", "let's ship it"]
allowed-toolsRuxsat so‘ramasdan ishlatish mumkin bo‘lgan vositalar["Read", "Bash(npm run build)"]
disable-model-invocationtrue - faqat foydalanuvchi chaqira oladiXavfli amallar uchun
user-invocablefalse - faqat Claude chaqira oladiFon ma’lumotlari uchun
pathsSkill faol bo‘ladigan glob andozalari["src/**/*.ts"]
context: forkIzolyatsiyalangan subagentda ishga tushirishKontekst og‘ir bo‘lganda
agentIshga tushiriladigan subagent turiExplore, Plan, general-purpose
effortMulohaza yuritish darajasilow, medium, high, xhigh, max
modelSkill uchun tanlanadigan modelclaude-opus-4-7
hooksSkill hayot siklidagi hooklarHooklar bo‘limiga qarang

disable-model-invocation: true maydoni avtomatik ishlamasligi kerak bo‘lgan hamma narsa uchun zarur. Masalan, shu bayrog‘i yoqilgan deploy-to-prod skillini foydalanuvchi faqat /deploy-to-prod deb aniq yozsa chaqirish mumkin. Bayroq bo‘lmasa, Claude “kod tayyor ko‘rinadi” degan xulosaga kelib deploy qilishi mumkin.

Nega ishning 90% i description’ga bog‘liq va uni qanday yozish kerak?

Asosiy xulosalar

Description — sessiya boshida Claude ko‘radigan yagona maydon. U yomon yozilgan bo‘lsa, ko‘rsatmalar matni mukammal bo‘lsa ham skill ishlamaydi. Yaxshi description uch qismdan iborat: u nima qiladi + qo‘shtirnoq ichidagi trigger iboralari + qachon ishlatmaslik kerakligi. Anthropic o‘zining skill-creator vositasida description’larni “biroz qat’iyroq” yozishni tavsiya qiladi — Claude skillni odatda kerak bo‘lganidan kamroq faollashtiradi.

Vibe-coderlar eng ko‘p yo‘l qo‘yadigan xato — “X uchun yordamchi” kabi description yozish. Skill papkasida jismonan mavjud bo‘ladi, lekin Claude uni chaqirmaydi.

Yomon description

description: Boshqaruv panellarini yaratadi.

Claude nimalarni aniqlay olmaydi: foydalanuvchi “haftalik savdoni ko‘rsat” desa, bu boshqaruv paneliga taalluqlimi? “Daromad grafigi” so‘ralsa, bu boshqaruv panelimi yoki shunchaki umumiy grafikmi? “Oylik hisobot” so‘ralsa, bu aniq boshqaruv paneliga aloqasi yo‘qmi?

Anthropic’ning o‘z skill-creator hujjati tavsiyani aniq bayon qiladi:

Claude hozircha skilllarni “kam faollashtirishga”, ya’ni foydali bo‘ladigan joyda ishlatmaslikka moyil. Bunga qarshi description’larni biroz “qat’iyroq” yozing.

— Anthropic Skill Creator (SKILL.md), https://github.com/anthropics/skills/blob/main/skills/skill-creator/SKILL.md

Yaxshi description formulasi

Uch qism:

  1. U nima qiladi - jarayon haqida emas, natija haqida bitta jumla. “SQL yaratadi” emas, “Telegram kanali uchun savdolarni jadvalga chiqaradi”.
  2. Qachon ishga tushirish kerak - foydalanuvchilar amalda aytadigan, qo‘shtirnoq ichidagi 3-5 ta ibora. Taxmin qilmang; chat va qo‘llab-quvvatlash tarixini ko‘ring.
  3. Qachon ishga tushirmaslik kerak - skill javob bermasligi kerak bo‘lgan o‘xshash vazifalar haqida 1-2 ibora. Bu qism bo‘lmasa, o‘xshash ikkita skill bir-biri bilan to‘qnashishda davom etadi.

Loyihamdagi kuchli description namunasi (soddalashtirilgan va shaxsi ko‘rsatilmaydigan qilingan):

description: |
  Tahrir siyosatiga rioya qilgan holda blog uchun SEO qo‘llanmasini yozadi va nashr etadi.
  Triggerlar: "X haqida qo‘llanma yoz", "yangi asosiy mavzu yaratamiz",
  "Y haqida blog maqolasi", "Z uchun blog qo‘llanmasini tuz".
  So‘rov email xabarnomasi, Telegram posti
  yoki jamoa ichidagi ko‘rsatma haqida bo‘lsa, faollashtirmang —
  bular boshqa skilllar.

Bu yerda nimalar ishlaydi:

  • “Yordam beradi” o‘rniga “yozadi va nashr etadi” fe’llari aniq natijani bildiradi.
  • Qo‘shtirnoq ichidagi to‘rtta trigger iborasi turli ifodalarni qamrab oladi.
  • Inglizcha trigger ham kiritilgan — foydalanuvchi jamoa tiliga o‘tsa ham skill ishlaydi.
  • Alohida “faollashtirmang” qismi email va post skilllari bilan to‘qnashuvning oldini oladi.

Description’ni qanday sinash kerak

Anthropic skill-creator ichiga trigger-evals metodologiyasini kiritgan: skill faollashishini tekshirish uchun 20 ta prompt. O‘ntasi uni faollashtirishi, o‘ntasi esa faollashtirmasligi kerak (jumladan, iborasi o‘xshash, lekin vazifasi boshqa bo‘lgan yaqin holatlar).

Vibe-coder tili bilan aytganda: description’ni yozgach, yangi bo‘sh chat ochib, haqiqatda ishlatadigan 5 ta ibora va o‘xshash eshitilib, boshqa ma’noni bildiradigan 3 ta iborani sinab ko‘ring. Skill kerakli vaziyatda faollashmasa yoki kerak bo‘lmagan joyda faollashsa, description’ni qayta ko‘rib chiqing. Shundan keyingina ko‘rsatmalar matnini yozing.

Avval qaysi 5 ta skillni o‘rnatgan bo‘lardim?

Asosiy xulosalar

Tadbirkor uchun eng tezkor strategiya — tayyor to‘plamlardan boshlash va ularni o‘ziga moslashtirish. Anthropic va Vercel odatiy vazifalar, jumladan hujjatlar va dizayn uchun bir buyruq bilan o‘rnatiladigan ochiq to‘plamlarni nashr etgan. 2026-yil may holatiga ko‘ra, Anthropic’ning rasmiy anthropics/skills repozitoriysida taxminan 138 000 yulduz bor.

Dastlabki ikki haftani o‘z skilllaringizni yozishga sarflash — yutqazadigan strategiya. Tayyorlarini o‘rnatib, qanday yaratilganini ko‘ring; keyin xuddi shu yondashuvda o‘zingiznikini qo‘shing. Isbotlangan, boshqalar yaratgan to‘plamlarni olib, o‘zingizga moslashtirish hammasini noldan qurishdan arzonroq. Men boshlash uchun beshta to‘plamni tavsiya qilaman:

1. anthropics/skills - skill-creator’li rasmiy to‘plam

Repozitoriy: github.com/anthropics/skills. GitHub’da 138 000 yulduz. Unda Anthropic jamoasining rasmiy skilllari bor: skill-creator (boshqa skilllarni yozadigan meta-skill), claude-api (API integratsiyalarini yaratishga yordam beradi) va PowerPoint, Excel, Word hamda PDF uchun tayyor hujjat skilllari.

Claude Code bilan o‘rnatish:

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

Asosiy qiymati — skill-creator. U tavsifingiz asosida SKILL.md yozadi, so‘ng 20 ta trigger-evals sinovini o‘tkazadi va skill kerakli joylarda faollasha boshlaguncha description’ni qayta ko‘rib chiqadi. Mohiyatan, bu “skill yaratish uchun skill”.

2. mattpocock/skills - TypeScript mutaxassisining viral to‘plami

Unda 12 ta faol skill bor, jumladan:

O‘rnatish:

npx skills@latest add mattpocock/skills
/setup-matt-pocock-skills

3. coreyhaines31/marketingskills - marketologlar uchun to‘plam

Onlayn dasturlar yuritsangiz, frilanser marketolog bo‘lib ishlasangiz yoki agentlik boshqarsangiz, o‘z skilllaringizni yozishga olti oy sarflashingiz shart emas. Vazifalarning yarmi allaqachon tayyorlangan.

4. vercel-labs/agent-skills - sun’iy intellektga o‘xshamaydigan dizayn

Repozitoriy: github.com/vercel-labs/agent-skills. Yetakchi skilli — web-design-guidelines; haftasiga taxminan 133 000 marta o‘rnatiladi. U UI kodini 100 dan ortiq qulaylik, unumdorlik va foydalanish osonligi qoidalari bo‘yicha tekshiradi.

Bunga qo‘shimcha ravishda, Anthropic frontend-design haftasiga 110 000 dan ortiq o‘rnatiladi. U AI’ga kod yozishni boshlashdan oldin uslub tanlashni o‘rgatadi. Usiz Claude yaratgan har bir sahifada Inter shrifti, binafsha gradient va panjarali kartalar bo‘ladi. Natija hamma uchun bir xil.

5. obra/superpowers - ko‘p agentli ish jarayoni

Umuman olganda, ushbu ro‘yxatdagi dastlabki uchtasini — anthropics/skills, mattpocock/skills va coreyhaines31/marketingskills — o‘rnatsangiz, Claude Code birinchi oyning o‘zida tadbirkor vazifalarining aksariyatini qamrab oladigan o‘nlab tayyor skillga ega bo‘ladi.

Qaysi takroriy vazifalarni skillga aylantirish kerak?

Asosiy xulosalar

Qoida oddiy: haftasiga ikki martadan ko‘p bajaradigan va taxminan bir xil qadamlarga ega har qanday ish skill uchun nomzod. “Auditor uchun yiliga bir marta tayyorlanadigan hisobot” kabi murakkab ish emas, balki odatiy ishlar: kanal uchun kontent rejasi, mijoz cheklarining tekshiruvi, yangi ishtirokchiga xush kelibsiz xati. Skill bir martalik mehnatni sizsiz ishlaydigan aktivga aylantiradi.

Mijozlar bilan ishlashda va boshqalarning loyihalarida bu holatni o‘nlab marta ko‘rganman. Kimdadir “har safar noldan qiladigan o‘sha ishi” bo‘ladi. Har dushanba bir xil turdagi hisobot yozadi. Har safar yangi mijoz kelganda bir xil tartibdan o‘tadi. Har bir nashr bir xil shablonga amal qiladi. Qadamlarni eslash, kerakli fayllarni ochish va Claude uchun so‘rov matnini qayta tuzish kerak bo‘lgani sababli, har safar 30-90 daqiqa ketadi.

Yechim — buni bir marta skillga jamlash. Shundan keyin bitta ibora aytasiz, Claude metodologiyani yuklaydi, kerakli manbalarni o‘qiydi va natijani tayyorlaydi. Turli sohalardan uchta misol:

Misol 1. Frilanser marketolog - weekly-content-plan skilli

Qo‘lda nima qiladi: har dushanba uchta mijoz uchun bir haftalik Telegram postlarini tayyorlaydi. Mijozning brend ovozi qo‘llanmasini ochadi, so‘nggi postlarni ko‘rib chiqadi, mahsulot taqvimi asosida mavzular o‘ylab topadi va ilgaklar hamda punktlar bilan jadval tuzadi.

Skill ko‘rinishida bu besh qadamli ko‘rsatmaga aylanadi: mijozning tone-of-voice faylini o‘qish, mahsulot taqvimini o‘qish, takrorlanish bor-yo‘qligini bilish uchun oxirgi 10 ta postni tekshirish, turiga ko‘ra (savdoga yo‘naltirilgan, ekspertlik, shaxsiy) yettita mavzu topish va jadval chiqarish.

“X mijoz uchun haftaga postlarni rejalashtiraylik” buyrug‘i bir soatlik tayyorgarlikni uch daqiqalik kutishga aylantiradi. Marketolog natijani tekshiradi, aniq o‘zgartirishlar kiritadi va mijozga yuboradi.

Misol 2. Tashqi buxgalter - monthly-receipts-close skilli (muallif misoli)

Qo‘lda nima qiladi: portfeldagi har bir mijoz uchun har oy bank ko‘chirmasini eksport qiladi, uni buxgalteriya tizimidagi to‘lovlar bilan solishtiradi, tasniflanmagan to‘lovlarni belgilaydi, dastlabki daromad hisobotini tayyorlaydi va daromad tarkibini oldingi oy bilan taqqoslaydi.

Skill — olti qadamli ko‘rsatma va bank ko‘chirmalarini tahlil qiluvchi scripts/ papkasidagi bir nechta shell skript. “X mijoz uchun may oyini yoping” triggeri Claude’dan 4-5 daqiqada, noodatiy holatlarni belgilagan holda hisobot tayyorlashni so‘raydi.

Misol 3. Onlayn dastur yaratuvchisi - welcome-letter-new-participant skilli

Qo‘lda nima qiladi: yangi ishtirokchi pul to‘ladi va unga xush kelibsiz emailini yozish kerak. Yaxshi xush kelibsiz xati shaxsiy bo‘ladi: u ishtirokchi qaysi kanaldan kelgani, qaysi mahsulotni sotib olgani, qaysi guruhda ekani va unga qaysi materiallarni yuborish kerakligini hisobga oladi. “Salom, xursandmiz” shabloni buni uddalamaydi.

Skill Claude’ga knowledge/audience.md (bu odamlar kimligi), knowledge/products/<product>.md (ular nima olishi) va oxirgi uchta xush kelibsiz xatini (takrorlamaslik uchun) o‘qishni, so‘ng quyidagi tuzilma bo‘yicha email yozishni buyuradi: ilgak - mahsulot tafsilotlari - dastlabki uch qadam - xayrlashuv.

Qo‘lda bajarishdan bir necha barobar tezroq. Sifat barqarorroq, chunki Claude uchta manbani tekshirishni eslaydi, shoshayotgan odam esa ulardan birini o‘tkazib yuboradi.

Nimani skillga aylantirmaslik kerak

  • Bir martalik vazifalar. Soliq deklaratsiyasini topshirishda yiliga bir marta bajariladigan ish bo‘lsa, uni chatda Claude’ga tushuntiring. Skill 3+ marta takrorlangandan keyin o‘zini oqlaydi.
  • Juda umumiy vazifalar. “Marketingda yordam ber” skill emas; bu butun marketing sohasi. Skill — “haftalik kontent rejasi”: aniq natijali muayyan ish.
  • Takrorlanadigan qadamlari bo‘lmagan ishlar. Jarayon har safar boshqacha bo‘lsa, bu skill emas, bir martalik ish.

Skill Creator siz uchun skilllarni qanday yozadi?

Asosiy xulosalar

Skill Creator — Anthropic’ning /skill-creator buyrug‘i bilan ishga tushirilgan meta-skilli. U sizni oltita qadamdan olib o‘tadi: qoralama, sinash, baholash, takrorlash, optimallashtirish, qadoqlash. Natijada 20 ta trigger-evals bo‘yicha sinovdan o‘tgan, foydalanishga tayyor SKILL.md hosil bo‘ladi (10 tasi faollashishi, 10 tasi faollashmasligi kerak). Dasturchi bo‘lmaganlar uchun bu YAML’ni o‘rganmasdan yoki Claude bilan tortishmasdan birinchi ishlaydigan skillni yozishning eng tez yo‘li.

Muammo shundaki, birinchi urinishdayoq yaxshi skill yozish qiyin. Description ko‘pincha juda tor yoki juda keng bo‘lib qoladi, foydalanuvchilar ishlatadigan iboralarni qamrab olmaydi yoki qo‘shni skill bilan to‘qnashadi. Anthropic buni boshqa skilllarni yarata oladigan skill-creator meta-skillini chiqarish orqali hal qildi.

anthropics/skills’ni o‘rnatgach, Claude’ga /skill-creator deb yozing (yoki shunchaki “haftalik hisobot uchun skill yaratamiz” deng) va olti bosqichli ish jarayonini bajaring:

  1. Qoralama - skill-creator savollar beradi: skill nima qilishi, qaysi trigger iboralaridan foydalanish, qaysi manbalarni o‘qish va qaysi qadamlarni bajarish kerak. Natijada SKILL.md’ning birinchi versiyasi hosil bo‘ladi.
  2. Sinash - skill-creator 20 ta sinov so‘rovi yaratadi: skillni faollashtirishi kerak bo‘lgan 10 ta va triggerga o‘xshasa-da, faollashtirmasligi kerak bo‘lgan 10 ta (yaqin holatlar).
  3. Baholash - har bir so‘rovni yangi chatda bajarib, skill faollashganini tekshiradi. Keraksiz joyda faollashsa yoki kerakli joyda faollashmasa, natijani belgilaydi.
  4. Takrorlash - xatolarga qarab description’ni qayta yozadi va sinovlarni takrorlaydi.
  5. Optimallashtirish - yakuniy sayqal: 1024 belgilik limitdan oshmaganini va loyihadagi mavjud skilllar bilan to‘qnashuv yo‘qligini tekshiradi.
  6. Qadoqlash - yakuniy SKILL.md va ma’lumotnoma fayllarini to‘g‘ri tuzilmaga joylashtiradi.

Amalda jarayon shunday ko‘rinadi: Claude bilan 15-20 daqiqa gaplashasiz, aniqlashtiruvchi 7-8 ta savolga javob berasiz va oxirida kerakli triggerlarda faollashadigan, sinovdan o‘tgan tayyor skill olasiz.

Yana bir foydasi — skill-creator SKILL.md yozishning namunali uslubini ko‘rsatadi. Uning faylini ochib, format, ohang va qadamlar tuzilishini ko‘rishingiz mumkin. Bu vosita o‘zini o‘zi namoyish etadigan holat: uni o‘qib, o‘zingiznikini qanday yozishni o‘rganasiz.

Skills, CLAUDE.md, Subagents, MCP, Hooks: qaysi birini ishlatish kerak?

Asosiy xulosalar

Claude Code’da xatti-harakatni kengaytirish uchun beshta alohida primitiv bor va ular bir-birining o‘rnini bosa olmaydi. CLAUDE.md — doimiy loyiha bilimlari. Skills — trigger bilan faollashadigan takroriy ish jarayonlari. Subagents — alohida kontekstda parallel ish bajaradi. MCP tashqi tizimlarga (API, ma’lumotlar bazalari) ulaydi. Hooks hodisalarga avtomatik javob beradi. Vibe-coderlar eng ko‘p yo‘l qo‘yadigan xato — hamma narsani CLAUDE.md ichiga tiqish yoki hookni skill sifatida yaratishga urinish.

Men ko‘rib chiqqan loyihalardagi eng keng tarqalgan muammo shuki, CLAUDE.md ichida loyiha qoidalari, nashr qilishning bosqichma-bosqich ko‘rsatmalari, commit shabloni va ma’lumotlar bazasi tavsifi bir joyga jamlangan. Bu kontekstni ortiqcha yuklaydi va amalda ham ish bermaydi: model CLAUDE.md’ning hammasini triggerlari aniq bo‘lmagan umumiy kontekst sifatida qabul qilgani uchun, foydalanuvchi “nashr qil” deganda Claude tegishli ko‘rsatmani ishga tushirmaydi.

Yechim — har bir narsani tegishli primitivga biriktirish:

NimaQachon ishlatish kerakMisol
CLAUDE.mdDOIMO kerak bo‘ladigan bilim“Loyihada belgilangan til bor”, “matnda uzun tire ishlatmang”, “brend nomida ‘o’ harfi yoziladi”
SkillsTrigger bilan faollashadigan takroriy jarayon“Production’ga nashr qilish”, “haftalik post rejasi”, “mijoz hisoblarini oy uchun yopish”
SubagentsParallel ish yoki og‘ir kontekstni ajratish“Men yangi funksiyani rejalayotganimda xavfsizlik auditi”, “kod bazasini alohida sessiyada ko‘rib chiqish”
MCPTashqi tizimga ulanish“CRM’dan ma’lumot olish”, “trekerdan vazifalarni olish”, “saytni brauzerda tekshirish”
HooksHodisaga avtomatik javob“Edit’dan keyin tekshiruvni ishga tushirish”, “xavfli buyruqlarni bloklash”, “tugagach Telegram bildirishnomasi yuborish”

Qisqacha aytganda, ko‘p ish jarayonlari uchun Skills va MCP yetarli; Hooks odatiy ishlarni — kod tekshiruvlari, testlar va himoya qoidalarini — avtomatlashtiradi. Kontekst og‘irlashganda Subagents kerak bo‘ladi. Eng keng tarqalgan xato — skill ishlatilishi kerak bo‘lgan joyda subagent yaratish.

Qaror daraxti

“Claude’dan X ni bajarishini xohlayman” deb o‘ylaganingizda:

  1. Bu bilim doim kerakmi? Masalan, “Loyihada belgilangan til bor” yoki “uzun tire ishlatmaymiz”. → Uni CLAUDE.md ichiga joylashtiring.
  2. Bu hozir qo‘lda bajaradigan, trigger bilan ishga tushadigan jarayonmi? Masalan, “Har dushanba hisobot yozaman”. → Skill yarating.
  3. Tashqi tizimdan foydalanish kerakmi? Masalan, Stripe API yoki CRM’ingiz. → MCP server ulang.
  4. Claude Code hodisaga avtomatik javob berishi kerakmi? Masalan, har bir Edit’dan keyin linterni ishga tushirish. → Hook yozing.
  5. Vazifa og‘irmi, butun kontekstni egallaydimi va boshqa ishni parallel bajarish kerakmi? → Uni subagentda ishga tushiring.

Tadbirkor-vibe-coderlarning vazifalarining 90% i 1-3-toifalarga kiradi. Hooks va subagents — “bir vaqtda bitta vazifa” bosqichidan o‘tganingizda ishlatiladigan keyingi darajadagi vositalar.

Slash buyruqlari va Skills — bir xil narsa

Claude Code’dagi muhim o‘zgarish: eski slash-buyruq tizimi (.claude/commands/) va skills amalda birlashgan. .claude/commands/deploy.md va .claude/skills/deploy/SKILL.md fayllarining ikkalasi ham /deploy buyrug‘ini yaratadi. Nomlar mos kelsa, skill ustun keladi. Hali ham eski slash-buyruq formatidan foydalanayotgan bo‘lsangiz, skills’ga o‘ting; sintaksisi aniqroq va imkoniyatlari ko‘proq.

Skill ishlashiga xalaqit beradigan 7 ta xato

Asosiy xulosalar

Skill bilan bog‘liq eng keng tarqalgan muammolar Claude’dagi xatolar emas, skillning o‘zidagi xatolardir. Triggerlarsiz description, ortiqcha yuklangan 2,000 qatorli SKILL.md, bir-biri bilan to‘qnashadigan o‘xshash ikkita skill yoki “marketplace’dagi hamma narsani” yuklab olishga urinish. Bu xatolarning har biri skillning faollashishini yoki ishlash usulini buzadi.

1. Triggersiz description: skill faollashmaydi

Belgi: skill yozdingiz, tuzilishini tekshirdingiz, hammasi to‘g‘ri, lekin Claude foydalanuvchi so‘rovlarida uni chaqirmaydi. Sabab deyarli doimo bir xil: “Kontent yozish uchun yordamchi” kabi description. Claude qaysi iboralarga javob berishni bilmaydi. Yechim: description ichiga foydalanuvchilar amalda ishlatadigan 3-5 ta iborani qo‘shtirnoq ichida kiriting.

2. 500 qatordan oshgan SKILL.md: e’tibor susayadi

Anthropic fayl matnini 500 qator ichida saqlashni aniq tavsiya qiladi. Ko‘rsatmalaringiz 2,000 qator bo‘lsa, Claude diqqatini yo‘qotadi, qadamlarni qisman bajaradi va tartibini chalkashtiradi. Yechim: katta bo‘limlarni yonidagi fayllarga — examples/, references/, scripts/ — ko‘chiring va ularga SKILL.md ichida havola bering.

3. Uchta kichik skill o‘rniga “kontentga oid hamma narsa” uchun bitta skill

Jozibador tuyuladigan sozlama: Telegram postlari, landing page’lar va email hammasi jamlangan bitta katta content skilli. Bu ishlamaydi. Skill noto‘g‘ri so‘rovlarda faollashadi, metodologiyalarni aralashtiradi va o‘rtacha natija beradi. Yechim: bitta skill = bitta takrorlanuvchi ish. “Kontent” bo‘yicha chindan ham uchta odatiy ishingiz bo‘lsa, uchta skill yarating: telegram-post, landing-section, email-broadcast.

4. “Qachon ishlatmaslik kerak” qismi bo‘lmagan skill: to‘qnashuvlar

Belgi: loyihada o‘xshash ikkita skill bor va Claude noto‘g‘risini chaqiradi. Masalan, biri email xabarnomasi haqida, boshqasi esa dastur ishtirokchilari uchun xush kelibsiz xatlari haqida. “So‘rov umumiy pochta ro‘yxati haqida bo‘lsa, faollashtirmang” degan aniq band bo‘lmasa, xush kelibsiz xati skilli “email” tilga olingan har qanday so‘rovda ishga tushadi. Yechim: description’da salbiy holatlarni aniq yozing.

5. Loyihada 50 ta skill: description’lar qisqartiriladi

Claude Code hujjatlaridan:

Skill nomlari doimo kiritiladi, ammo skill ko‘p bo‘lsa, belgilar limiti ichida qolish uchun description’lar kesiladi va bu Claude so‘rovingizga moslik topishda foydalanadigan kalit so‘zlarni olib tashlashi mumkin. Budjet - model kontekst oynasining 1% i.

— Claude Code Documentation, https://code.claude.com/docs/en/skills

Marketplace’dan 50 ta skill to‘plamini yuklab olgan bo‘lsangiz, ayrim description’lar qisqartiriladi. Umid bog‘lagan kalit so‘zlaringiz yo‘qolishi mumkin. Yechim: faol loyihada eng foydali 10-15 ta skillni saqlang. Qolganlarini barcha topiladigan skills papkalaridan tashqarida, masalan o‘z materiallaringizdagi alohida skill-archive/ papkasida nofaol saqlang. Kerakli skill’larnigina loyiha yoki shaxsiy ko‘lamga o‘rnating. ~/.claude/skills/ — loyihalararo ko‘rinadigan o‘rnatilgan shaxsiy kutubxona; u yerga ko‘chirish skill’ni qidiruvdan olib tashlamaydi.

6. Ishonchsiz manbalardan olingan skilllar: xavfsizlik xatari

Anthropic bu haqda rasmiy hujjatlarida ogohlantiradi:

Skilllarni faqat ishonchli manbalardan foydalaning: o‘zingiz yaratgan yoki Anthropic’dan olgan skilllardan. Zararli skill Claude’ni unda ko‘rsatilgan maqsaddan farqli tarzda vositalarni chaqirishga yoki kod bajarishga undashi mumkin.

— Anthropic Agent Skills Overview, https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview

Tasodifiy GitHub repozitoriysidagi skill birinchi marta chaqirilgandayoq API kalitlaringizni sizdirishi mumkin. Yechim: o‘rnatishdan oldin SKILL.md’ni o‘zingiz ochib o‘qing. Noma’lum mualliflarning skilllarini muhim loyihalarda ishlatmang.

7. Bilim papkasi bo‘lmagan skill “o‘rtacha ChatGPT” natijasini beradi

Eng nozik va eng keng tarqalgan anti-pattern. Skill — metodologiya, ammo kontekstsiz metodologiyaning o‘zi hech narsani anglatmaydi. “Xush kelibsiz emailini yoz” skillini yaratsangiz-u, loyihada auditoriyani tasvirlaydigan fayl va brend ovozi fayli bo‘lmasa, Claude boshqa hammanikidan farq qilmaydigan, o‘rtacha ChatGPT emailini yozadi.

Skill loyihaning Second Brain tizimini CLAUDE.md haqidagi qo‘llanma tamoyillari asosida avvaldan yaratganingizdagina eng yaxshi ishlaydi. Avval bilim tuzilmasini yarating, keyin unga tayanadigan skilllarni tuzing. Tartibni teskarisiga o‘zgartirsangiz, uslubingizga mos shaxsiy ish o‘rniga odatiy, o‘rtacha sifatga ega natija olasiz.

Birinchi skillni 30 daqiqada qanday yaratish mumkin?

Asosiy xulosalar

Birinchi ishlaydigan skillni yaratish uchun bosqichma-bosqich retsept: bitta takrorlanuvchi ishni tanlang, qadamlarini yozib chiqing, papka tuzilmasini yarating, formula asosida description yozing, uni 5-8 ta so‘rov bilan sinang va kerakli joyda faollashguncha takrorlang. Birinchi skill uchun real muddat 30-40 daqiqa. Keyingi har biri 10-15 daqiqada tayyor bo‘ladi, chunki format tanish bo‘lib qoladi.

Loyihalarimda birinchi skilllarni yaratish uchun ishlatgan aniq reja mana:

1-qadam. Bitta takrorlanuvchi ishni tanlang

Oxirgi bir oylik taqvimingizni oching. Kamida 4-5 marta bajargan va har safar 30-60 daqiqa oladigan vazifani toping. “Marketing” kabi keng vazifa emas, balki aniq ish: “Dushanba kungi savdo hisoboti”, “yangi mijozni ishga kiritish” yoki “aksiya uchun narxlar ro‘yxatini yangilash”.

Ta’rif qanchalik aniq bo‘lsa, skill shunchalik sodda va trigger shunchalik ravshan bo‘ladi.

2-qadam. Jarayonni qo‘lda yozib chiqing

Alohida faylda yoki Claude bilan chatda (skill uchun emas, qoralama sifatida) bajaradigan qadamlaringizni yozing:

1. Mijozlar bazasini oching
2. "xush kelibsiz emailini kutmoqda" holati bo‘yicha filtrlang
3. Mijoz qaysi kanaldan kelganini tekshiring
4. Shu kanal uchun email shablonini "templates" papkasidan oling
5. Ism, mahsulot va boshlanish sanasini to‘ldiring
6. Yuboring

Bu hali skill emas, qaydlar. Ammo bu qaydlarsiz SKILL.md yozishga urinishning o‘ziyoq chalkashlikka olib keladi.

3-qadam. Papka tuzilmasini yarating

mkdir -p .claude/skills/welcome-email-new-client
touch .claude/skills/welcome-email-new-client/SKILL.md

Yoki skillni barcha loyihalaringizda ishlatmoqchi bo‘lsangiz, uni ~/.claude/skills/ ichiga joylashtiring.

4-qadam. Shablon asosida SKILL.md yozing

Qolip:

---
name: welcome-email-new-client
description: |
  Yangi mijoz uchun uning jalb etilish kanaliga mos shablondan foydalanib xush kelibsiz emailini tayyorlaydi.
  Triggerlar: "yangi X mijoz uchun xush kelibsiz emailini yoz",
  "Y yangi ishtirokchini ishga kirgiz", "Z kanalidan kelgan mijozga xush kelibsiz emaili".
  So‘rov umumiy pochta ro‘yxati
  yoki email kampaniyasi haqida bo‘lsa, faollashtirmang —
  bular boshqa skilllar.
---

# Welcome Email for a New Client

## Steps

1. `knowledge/audience/segments.md` faylini o‘qing - mijoz segmentlari qanday
2. `knowledge/templates/welcome/` papkasini o‘qing - kanal bo‘yicha shablonlar
3. So‘rov kontekstidan mijozning kanalini aniqlang
4. Mijozning ismi, mahsulot nomi va boshlanish sanasini kiriting
5. Uzunligini tekshiring — 800 belgidan oshmasin
6. Yakuniy email matnini nusxalashga tayyor formatda chiqaring

## Important

- “aziz do‘stim” yoki “salom” deb yozmang — tabiiy tildan foydalaning
- Bitta paragraf, bitta g‘oya
- Ikkita emas, bitta harakatga chaqiriq bilan yakunlang

5-qadam. 5-8 ta so‘rov bilan sinang

Ushbu loyihadagi Claude Code’da yangi bo‘sh chat oching. Haqiqatan ishlatadigan 5 ta ibora va skillni faollashtirmasligi kerak bo‘lgan, o‘xshash 3 ta iborani sinab ko‘ring:

Faollashishi kerak:

  • “Ivanov yangi mijozi uchun xush kelibsiz emailini yoz”
  • “X dasturini sotib olgan yangi ishtirokchini ishga kirgiz”
  • “Instagram’dan kelgan mijozga xush kelibsiz emaili”

Faollashmasligi kerak:

  • “Butun ro‘yxatga aksiya emailini yubor”
  • “Yangi yil bayramlari uchun email kampaniyasi”
  • “Pul to‘lamagan mijozga keyingi xatni yoz”

Har biri uchun skill faollashgan-faollashmaganini tekshiring. Noto‘g‘ri holatlarda faollashsa, description’ni toraytiring. Kerakli joylarda faollashmasa, trigger iboralarini kengaytiring.

6-qadam. Description’ni takrorlab yaxshilang

Har bir muvaffaqiyatsiz sinovdan keyin faqat description’ni tahrir qiling — ko‘rsatmalar matniga tegmang. 2-3 iteratsiyadan keyin skill ishonchli faollasha boshlaydi. Uni saqlang, commit qiling va har kuni ishlating.

Yakuniy maslahat: birinchi skillni mukammal qilishga urinmang. Uni ishlaydigan qiling. Sayqal beshinchi yoki o‘ninchi skilldan keyin, iboralaringiz va Claude javoblaridagi qoliplarni ko‘ra boshlaganingizda keladi.

Shu haftada taqvimingizdan takrorlanadigan bitta ishni tanlang, 30 daqiqa ajrating va yuqoridagi olti qadamni bajaring. Shunda Claude taxmin qilmay, sizning metodologiyangiz bo‘yicha ishlaydi.

Ailoot orqali AI modellaridan foydalanish kerak bo‘lsa, Ailoot bilan tanishing.

Batafsil

Ko‘p beriladigan savollar

Skill’ni ~/.claude/skills/ ga ko‘chirish uni nofaol qiladimi?

Yo‘q. Bu o‘rnatilgan shaxsiy ko‘lam, skill’ni barcha loyihalarda ochadi. Ishlatilmaydigan paketlarni barcha topiladigan skills papkalaridan tashqaridagi arxivda saqlang; hozir keraklilarinigina o‘rnating.

Description to‘g‘ri faollashishini qanday tekshiraman?

Skill’ni chaqirishi kerak bo‘lgan beshta ibora va chaqirmasligi kerak bo‘lgan uchta o‘xshash so‘rovni yangi chatlarda sinang. Qaysi skill yuklanganini yozing. Haqiqiy so‘rovni o‘tkazib yuborsa yoki o‘xshashiga noto‘g‘ri mos kelsa, description’ni tuzating.

Barcha maqolalar