> ## Documentation Index
> Fetch the complete documentation index at: https://flowglad.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

> Tashqi agentlar va Automations uchun qayta foydalaniladigan paketlar yarating

Skills — bu ko'rsatmalar va ixtiyoriy yordamchi fayllardan iborat qayta foydalaniladigan paketlar. Ular jamoangizga vazifani bajarishning takrorlanadigan usulini bir marta belgilab, so'ngra uni Flowglad bo'ylab izchil qo'llash imkonini beradi.

Har bir Skill nom, slash-buyruq slug'i, tavsif va Markdown'da yozilgan ko'rsatmalarga ega. Yordamchi fayllar ushbu ko'rsatmalarga amal qilish uchun zarur bo'lgan qo'shimcha kontekst yoki resurslarni taqdim etishi mumkin.

## Flowglad'dan jamoangizning Skill kutubxonasi sifatida foydalaning

Flowglad har bir Skill'ni versiyalangan paket sifatida saqlaydi. O'zgarishni nashr qilish oldingi paketni joyida almashtirish o'rniga yangi revision yaratadi. Tashkilot administratorlari Skill'ning **History** bo'limini ochib, uning revisionlarini ko'rib chiqishi, o'zgarishlarni taqqoslashi, oldingi revisionni tiklashi yoki bu amallar mavjud bo'lganda draft'ni bekor qilishi mumkin.

Bu jamoangizga qayta foydalaniladigan ko'rsatmalarni boshqariladigan yagona joyda yuritish imkonini beradi va ma'lum bir vaqtda qaysi versiya faol bo'lganini saqlab qoladi. Draft va rad etilgan revisionlar faol versiyani almashtirmaydi.

### Skills'ni MCP orqali boshqarish

Flowglad MCP serverini ulaganingizdan so'ng, agent siz uchun tashkilotingizning Skill kutubxonasini ko'rib chiqishi va boshqarishi mumkin:

* `skills.list` ulanishga ko'rinadigan Skills'ni qaytaradi.
* `skills.get` bitta Skill uchun eng so'nggi va faol revision metama'lumotlarini qaytaradi.
* `skills.create` yangi Skill paketini yuboradi.
* `skills.create_candidate` mavjud Skill'ning yangi revisionini yuboradi.
* `skills.publish_revision` kechiktirilgan revisionni tekshiradi va nashr qiladi.
* `skills.create_package_upload_session` va `skills.finalize_package_upload_session` inline yuborish uchun juda katta bo'lgan paketlarni uzatadi.
* `skills.get` qabul qilingan so'rovning tekshiruv va ko'tarish natijasi haqida xabar beradi.

Skills yaratish yoki yangilash uchun jamoadoshning tashkilot a'zoligida ham, MCP ulanishining grant'ida ham `skills:write` ruxsati talab qilinadi. Agar ruxsatni serverni ulagandan keyin qo'shsangiz, yozish vositalari mavjud bo'lishi uchun Flowglad MCP'ni qayta ulang va `skills:write` ni avtorizatsiya qiling.

**Ruxsatlar:** Administratorlar sukut bo'yicha Skill yaratish huquqiga ega. Contributor'ga xuddi shunday huquq berish uchun **Settings** → **Team** ni oching, jamoadoshni tanlang va **Skill Authoring** ni yoqing. Bu jamoadoshni administrator qilmasdan tashkilot Skills'ini yaratish va yangilash ruxsatini beradi.

## Flowglad MCP Skills'ni agentingizga yuklang

Flowglad MCP serveri MCP initsializatsiyasi paytida `io.modelcontextprotocol/skills` ni e'lon qiladi. Bu mos klientlarga server `skills/list` va `skills/get` agent Skill metodlarini amalga oshirishini bildiradi. Qaytarilgan har bir Skill `skill://` resurs URI'lari va kontent digest'larini o'z ichiga oladi; klientlar fayllarni `resources/read` orqali olishlari mumkin.

Serverni ulash klient `skills/list` ni chaqirishini yoki qaytarilgan paketlarni o'rnatishini kafolatlamaydi. Klient qo'llab-quvvatlashi har xil. Agent har bir sessiya boshida Flowglad reyestrini yangilashini xohlasangiz, ChatGPT / Codex yoki Claude'ga ishga tushirish ko'rsatmasini qo'shing.

**MCP nomlanishi:** Nomlar ataylab farqlanadi. Nuqtali `skills.list` — tashkilotingizning versiyalangan Skill yozuvlari uchun Flowglad vositasi. Slash'li `skills/list` — agentga mo'ljallangan Skill paketlarini topish uchun MCP protokoli kengaytma metodi.

### Ishga tushirish ko'rsatmasini qo'shing

Yangi sessiyani boshlashdan oldin maqsad katalogini bir marta yarating, so'ngra quyidagi mos ko'rsatma blokini qo'shing.

#### ChatGPT / Codex

ChatGPT / Codex maqsad katalogini `mkdir -p ~/.agents/skills` bilan yarating.

Quyidagi blokni har bir loyihaga qo'llash uchun `~/.codex/AGENTS.md` ga yoki repozitoriy jamoasi bilan ulashish uchun o'sha repozitoriyning `AGENTS.md` fayliga joylashtiring.

```markdown AGENTS.md theme={null}
## Flowglad MCP Skill bootstrap

At the start of every new session, before handling the first task:

1. Confirm that the Flowglad MCP server is connected.
2. Refresh the agent Skill catalog from Flowglad. Prefer the advertised `skills/list` MCP extension method. If the client does not expose that method directly, use the Flowglad server's `resources/list` method and select resources whose URIs begin with `skill://flowglad/`.
3. For every returned Skill, retrieve its manifest with `skills/get` when available, then read each listed resource with `resources/read`, beginning with `SKILL.md`.
4. Synchronize the package into `~/.agents/skills/<skill-name>/`. Compare the returned content digests and rewrite only new or changed Flowglad-managed files. Never overwrite or delete unrelated local Skills.
5. Treat the refreshed Flowglad package as the source of truth for this session. Make the synchronized Skills available for automatic matching and explicit `$skill-name` invocation.
6. If this ChatGPT / Codex client cannot call the Skill or resource methods, report that limitation once and continue without claiming that the registry was refreshed.
```

#### Claude

Claude maqsad katalogini `mkdir -p ~/.claude/skills` bilan yarating.

Quyidagi blokni har bir loyihaga qo'llash uchun `~/.claude/CLAUDE.md` ga yoki repozitoriy jamoasi bilan ulashish uchun o'sha repozitoriyning `CLAUDE.md` fayliga joylashtiring.

```markdown CLAUDE.md theme={null}
## Flowglad MCP Skill bootstrap

At the start of every new session, before handling the first task:

1. Confirm that the Flowglad MCP server is connected.
2. Refresh the agent Skill catalog from Flowglad. Prefer the advertised `skills/list` MCP extension method. If the client does not expose that method directly, use the Flowglad server's `resources/list` method and select resources whose URIs begin with `skill://flowglad/`.
3. For every returned Skill, retrieve its manifest with `skills/get` when available, then read each listed resource with `resources/read`, beginning with `SKILL.md`.
4. Synchronize the package into `~/.claude/skills/<skill-name>/`. Compare the returned content digests and rewrite only new or changed Flowglad-managed files. Never overwrite or delete unrelated local Skills.
5. Treat the refreshed Flowglad package as the source of truth for this session. Make the synchronized Skills available for automatic matching and explicit `/skill-name` invocation.
6. If this Claude client cannot call the Skill or resource methods, report that limitation once and continue without claiming that the registry was refreshed.
```

ChatGPT / Codex yoki Claude'dan tegishli blokni o'zining foydalanuvchi darajasidagi ko'rsatmalar fayliga qo'shishni so'rashingiz mumkin. Taklif qilingan tahrirni qabul qilishdan oldin ko'rib chiqing, chunki bu fayl kelgusi sessiyalarga ta'sir qiladi. Ko'rsatma — bu imkon qadar harakat qiladigan agent bootstrap'i; agar muhitingiz Skills'ni deterministik tarzda yangilashi kerak bo'lsa, xuddi shu sinxronizatsiyani ishonchli `SessionStart` hook'ida yoki MCP klient integratsiyangizda amalga oshiring.

## Skills qayerda ishlatiladi

Skills'ning hozirda ikkita iste'molchisi bor:

* Mos tashqi agentlar yoqilgan paketlarni Flowglad MCP orqali topadi va sinxronlaydi, so'ngra ularni avtomatik ravishda moslashtiradi yoki nomi bo'yicha chaqiradi.
* Automations aniq nashr qilingan Skill revisionini OWS `skill-revision` kod resursi sifatida biriktiradi. Automation paket yo'li va kirish nuqtasini tanlaydi; agent qadamlari faqat muhrlangan ishga tushirish imkoniyatlari to'plami tomonidan avtorizatsiya qilingan Skills'ni oladi.

Birinchi yo'l tashqi agentga qayta foydalaniladigan ko'rsatmalarni taqdim etadi. Ikkinchisi takrorlanadigan Automation ishga tushirilishiga o'zgarmas kod va yordamchi fayllarni taqdim etadi. Nashr qilingan Skills butun tashkilot bo'ylab amal qiladi, shuning uchun avtorizatsiya qilingan Automation istalgan Space'da bir xil Skill revisionini tanlashi mumkin. Iste'mol qiluvchi Automation va uning ishga tushirilishlari o'z Space'iga tegishli bo'lib qoladi; Skill'ni tanlash bu chegarani o'zgartirmaydi.

## Skills yaratish va yuritish

**organization menu** → **Skills** → **New Skill** ni oching. **Skill** yorlig'ida **Name**, **Slug**, ixtiyoriy **Description** va qayta foydalaniladigan ko'rsatmalarni **Markdown** da kiriting. Har qanday yordamchi paket fayllari uchun **Files** yorlig'idan foydalaning, so'ngra **Create Skill** ni tanlang.

Slug kichik harflar, raqamlar va defislardan iborat bo'lib, harf yoki raqam bilan boshlanadi va foydalanuvchilar `/` dan keyin shuni yozadi.

Skill yaratish yoki tahrirlash draft hosil qiladi. Skill tafsilotlari sahifasida tahrirlar avtomatik saqlanadi; draft'ni tekshirish va nashr qilish uchun **Publish Draft** ni tanlang. Agar tekshiruv muvaffaqiyatsiz bo'lsa, draft'ni tuzatish uchun ko'rsatilgan diagnostikadan foydalaning va qayta nashr qiling.

Revisionlarni ko'rib chiqish, almashtirilgan revisionni tiklash yoki bu amallar mavjud bo'lganda o'zgaruvchan draft'ni bekor qilish uchun **History** dan foydalaning. **Disable Skill** revision tarixini o'chirmasdan uni tashqi agent tomonidan topilishi va Automation resolution'idan olib tashlaydi; **Enable Skill** uni yana mavjud qiladi.

## MCP bilan Skill yaratish yoki tahrirlash

Paketga asoslangan yaratish uchun ulangan tashqi MCP klientidan foydalaning. Mavjud Skill'ni tahrirlashdan oldin `skills.get` ni chaqiring. Yangi paket uchun `skills.create` dan yoki joriy faol revisionga asoslangan revision uchun `skills.create_candidate` dan foydalaning.

Kichik paketlarni inline taqdim etish mumkin. Kattaroq paketlar uchun `skills.create_package_upload_session` ni chaqiring, so'ralgan obyektlarni yuklang va `skills.finalize_package_upload_session` bilan yakunlang. Agar tekshiruv kechiktirilgan bo'lsa, `skills.publish_revision` ni chaqiring. Qabul qilingan lifecycle so'rovi va uning tekshiruv yoki ko'tarish natijasi uchun `skills.get` ni so'rab turing.

Skill'ni nashr qilish Automation yaratmaydi, qayta ko'rib chiqmaydi yoki faollashtirmaydi; kerak bo'lganda Automation MCP lifecycle'idan aniq foydalaning.

## Skill shablonidan boshlang

**Skills** sahifasida **Skill Templates** mavjud. Katalogni qidiring yoki filtrlang, shablonni oldindan ko'ring va **Copy Skill** ni tanlang. Nusxa boshqa har qanday Skill kabi tahrirlanishi va nashr qilinishi mumkin bo'lgan tashkilot Skill'iga aylanadi.

## Skills va Automations

Skill qayta foydalaniladigan ishni qanday bajarishni belgilaydi. U bu ish qachon bajarilishini hal qilmaydi.

Ish qo'lda, jadval bo'yicha yoki voqeaga javoban bajarilishi kerak bo'lganda Automation'dan foydalaning. Automation bir yoki bir nechta Skill revisionini biriktirishi mumkin, shunda bir xil implementatsiya ishga tushirishlar bo'ylab qayta ishlatiladi.


## Related topics

- [MCP](/docs/uz/mcp-server.md)
- [Automations](/docs/uz/automations.md)
- [Xush kelibsiz](/docs/uz/agents/introduction.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.