Skip to main content

Claude Code Skills tizimi

Claude Code Skills

Claude Code ning eng kuchli, lekin kam tushinilgan xususiyatlaridan biri — Skills. Bu — agent uchun "kontekstli yordamchilar": bir kategoriya vazifa kelganida — Claude tegishli skill-faylni avtomatik o'qiydi va uning instruktsiyalariga amal qiladi. Skill bir nechta promtni qayta yozish o'rniga — bir marta tuzasiz va keyingi har sessiyada avtomatik qo'llaniladi.

Ushbu qo'llanmada Skills nima, ularni qanday yozish va qaerda foydalanish haqida.

Skill nima?​

Bu — papka, ichida SKILL.md (tavsif + qachon ishlatish) va qo'shimcha fayllar (skriptlar, shablon, ma'lumotlar).

.claude/skills/my-skill/
├── SKILL.md              ← asosiy fayl
├── scripts/
│   └── helper.py         ← yordamchi skript
├── templates/
│   └── output.md         ← shablon
└── references/
    └── api-spec.md       ← qo'shimcha hujjat

SKILL.md faylda frontmatter shaklida — qachon shu skill ishlatilishi kerakligi yoziladi. Claude foydalanuvchi savolida shu trigger-larni topadi va avtomatik chaqiradi.

SKILL.md tuzilishi​

Standart shablon:

---
name: my-skill
description: Bu skill X vazifani Y holatda bajaradi. Triggerlar — A, B, C
allowed-tools: Read, Write, Bash
---

# My Skill — qisqacha sarlavha

## Qachon foydalanish

- Foydalanuvchi A so'rasa
- B holatida
- C kontekstida

## Qanday ishlash

1. Birinchi qadam: ...
2. Ikkinchi qadam: ...

## Misol

[konkret misol]

## Anti-paternlar

- Ushbu skill X holatida ishlatilmaydi

Eng muhim qism — description. Aniq trigger-so'zlar yozing. Claude foydalanuvchi savolini bu bilan solishtiradi:

  • Yomon: "Kod bilan ishlash uchun"
  • Yaxshi: "Python testlarini yozish: pytest, fixture, parametrize, mocking. Triggerlar: «test yoz», «pytest», «mock qil», «fixture qo'sh»"

Skill qachon kerakli, qachon yo'q​

Kerakli:​

  • Takrorlanadigan vazifa: 5+ marta bir xil promtni yozsangiz — skill qiling
  • Ko'p qadamli protokol: "deploy" — backup → build → test → push → notify
  • Sezgir vazifa: "prod-DB ga query" — har doim DRY-RUN, har doim transaction
  • Format-strict chiqish: "audit-report" — aniq markdown shabloni

Kerakmas:​

  • Bir martalik vazifa
  • Promtning o'zi 2 qator
  • Agentning umumiy bilimi yetadi (masalan, "Python list comprehension")

Skill darajalari​

Skills uch joydan o'qiladi:

  1. Global: ~/.claude/skills/<name>/ — barcha loyihalarda
  2. Loyiha: .claude/skills/<name>/ — bitta loyihada
  3. Plugin: paket sifatida o'rnatilgan

Global — sizning shaxsiy "kunlik" skill-laringiz. Loyiha — komandaviy, git'da saqlanadi.

Amaliy misollar​

Skill: "PR review"​

---
name: pr-review
description: Pull request ni ko'rib chiqish. Triggerlar: «PR ko'rib chiq», «review qil», «#1234 ni tekshir»
allowed-tools: Bash, Read
---

# PR Review

## Tekshirish ro'yxati

1. `git diff origin/main` — barcha o'zgarishlar
2. Test fayllari qo'shildimi (yangi xususiyat uchun)?
3. Sezgir o'zgarishlar (auth, payment, prod config) — `git log -p` bilan tekshirib chiqing
4. Linter / formatter — toza?
5. Hujjat yangilandi (README, API)?

## Chiqish formati

- ✅ to'g'ri o'zgarishlar
- ⚠️ qulay (lekin kerakli emas) o'zgarishlar
- 🛑 blokerlar

Skill: "Deploy"​

---
name: deploy
description: Loyihani prodga deploy qilish. Triggerlar: «deploy», «chiqaramiz», «production ga»
allowed-tools: Bash, Read, Write
---

# Deploy

## Pre-deploy checklist

- [ ] Barcha testlar yashil
- [ ] Local build muvaffaqiyatli
- [ ] DB backup yangi (24 soatdan eski emas)
- [ ] Rollback komandasi ma'lum

## Bajarish

1. `pnpm test` — yashil bo'lishi kerak
2. `pnpm build`
3. `rsync -avz dist/ prod:/app/`
4. `ssh prod 'pm2 reload all'`
5. Smoke test: `curl https://example.com/health`

Har bir qadamdan keyin — foydalanuvchidan tasdiqlash so'rang.

## Rollback

`ssh prod 'rsync -a /app.backup/ /app/ && pm2 reload all'`

Skill yozish bo'yicha maslahatlar​

  • Aniq description: bu — eng katta omil. Trigger so'zlar real promtga to'g'ri kelishi kerak
  • Minimal kontekst: faqat shu skill uchun kerakli ma'lumot. Boshqa skill-larga aralashish — yomon
  • References papkasi: katta ma'lumotlar (API docs, schemas) — alohida faylda, SKILL.md ulardan link bilan qo'shadi
  • Test qiling: skill yozdingiz — 5 ta turli promt bilan tekshirib ko'ring, hammasi ishlaydimi?

Mavjud kutubxonalar​

Anthropic Skills marketplace va GitHub-da hamjamiyat tomonidan yozilgan yuzlab tayyor skill-lar bor. Kategoriyalar:

  • Code review — turli tillarda
  • Testing — pytest, vitest, playwright
  • DevOps — docker, kubernetes, terraform
  • Hujjatlashtirish — API docs, README
  • Refaktoring — security, performance, structure
  • Marketing kontenti — email, posts, SEO

Boshlash uchun: claude skill marketplace (CLI komandasi) yoki Anthropic skills repo.

Skill vs MCP server vs CLAUDE.md​

VositaQachon
CLAUDE.mdDoim kontekstda, kichik (qoidalar, konvensiyalar)
SkillVaqti-vaqti bilan, trigger bo'yicha (vazifa-spetsifik)
MCP serverTashqi tizim bilan ishlash (file, API, DB)

To'g'ri tanlov: agar har sessiyada kerak — CLAUDE.md. Agar faqat ba'zida — skill. Agar tashqi servisga ulanish — MCP.

Anti-paternlar​

  • Bitta katta skill: barcha narsalarni bir SKILL.md ga tiqish. Yomon — Claude triggerni topa olmaydi
  • Description o'rniga obscure: "Smart helper" — modelga hech narsa demaydi
  • Skill ichida hard-coded API keylar: hech qachon. ${ENV_VAR} qo'llanmadan o'qing
  • Yangilanmaydigan skill: API o'zgardi, skill eski qoldi. Reviewing oyiga bir marta

Keyingi qadamlar​