> ## 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

> Створюйте повторно використовувані пакети для зовнішніх агентів і Automations

Skills — це повторно використовувані пакети інструкцій і необов'язкових допоміжних файлів. Вони дають змогу вашій команді один раз визначити повторюваний спосіб виконання завдання, а потім послідовно застосовувати його в усьому Flowglad.

Кожен Skill має назву, slug для slash-команди, опис та інструкції, написані в Markdown. Допоміжні файли можуть надавати додатковий контекст або ресурси, потрібні для виконання цих інструкцій.

## Використовуйте Flowglad як бібліотеку Skills вашої команди

Flowglad зберігає кожен Skill як версійований пакет. Публікація зміни створює нову ревізію замість заміни попереднього пакета на місці. Адміністратори організації можуть відкрити **History** Skill, щоб переглянути його ревізії, порівняти зміни, відновити попередню ревізію або відхилити чернетку, якщо ці дії доступні.

Це дає вашій команді одне кероване місце для підтримки повторно використовуваних інструкцій зі збереженням інформації про те, яка версія була активною в певний момент. Чернетки та відхилені ревізії не замінюють активну версію.

### Керування Skills через MCP

Після підключення MCP-сервера Flowglad агент може переглядати бібліотеку Skills вашої організації та керувати нею від вашого імені:

* `skills.list` повертає Skills, видимі для підключення.
* `skills.get` повертає метадані останньої та активної ревізії для одного Skill.
* `skills.create` надсилає новий пакет Skill.
* `skills.create_candidate` надсилає нову ревізію наявного Skill.
* `skills.publish_revision` перевіряє та публікує відкладену ревізію.
* `skills.create_package_upload_session` і `skills.finalize_package_upload_session` передають пакети, завеликі для надсилання inline.
* `skills.get` повідомляє результат перевірки та просування прийнятого запиту.

Для створення або оновлення Skills потрібен дозвіл `skills:write` як у членстві колеги в організації, так і в наданих правах MCP-підключення. Якщо ви додали дозвіл після підключення сервера, повторно підключіть Flowglad MCP і авторизуйте `skills:write`, щоб інструменти запису стали доступними.

**Дозволи:** адміністратори за замовчуванням мають доступ до створення Skills. Щоб надати такий самий доступ Contributor, відкрийте **Settings** → **Team**, виберіть колегу та ввімкніть **Skill Authoring**. Це надає дозвіл створювати й оновлювати Skills організації, не роблячи колегу адміністратором.

## Завантаження Skills з Flowglad MCP у ваш агент

MCP-сервер Flowglad оголошує `io.modelcontextprotocol/skills` під час ініціалізації MCP. Це повідомляє сумісним клієнтам, що сервер реалізує методи Skills для агентів `skills/list` і `skills/get`. Кожен повернутий Skill містить URI ресурсів `skill://` і дайджести вмісту; клієнти можуть отримати файли за допомогою `resources/read`.

Підключення сервера не гарантує, що клієнт викличе `skills/list` або встановить повернуті пакети. Підтримка в клієнтах різниться. Додайте інструкцію запуску до ChatGPT / Codex або Claude, якщо хочете, щоб агент оновлював реєстр Flowglad на початку кожного сеансу.

**Іменування MCP:** назви навмисно різні. `skills.list` із крапкою — це інструмент Flowglad для версійованих записів Skills вашої організації. `skills/list` зі скісною рискою — це метод розширення протоколу MCP для виявлення пакетів Skills, призначених для агентів.

### Додайте інструкцію запуску

Один раз створіть цільовий каталог перед початком нового сеансу, а потім додайте відповідний блок інструкцій нижче.

#### ChatGPT / Codex

Створіть цільовий каталог ChatGPT / Codex за допомогою `mkdir -p ~/.agents/skills`.

Розмістіть наведений нижче блок у `~/.codex/AGENTS.md`, щоб застосувати його до кожного проєкту, або в `AGENTS.md` репозиторію, щоб поділитися ним із командою цього репозиторію.

```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 за допомогою `mkdir -p ~/.claude/skills`.

Розмістіть наведений нижче блок у `~/.claude/CLAUDE.md`, щоб застосувати його до кожного проєкту, або в `CLAUDE.md` репозиторію, щоб поділитися ним із командою цього репозиторію.

```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 або Claude додати відповідний блок до власного файлу інструкцій рівня користувача. Перегляньте запропоноване редагування, перш ніж приймати його, оскільки цей файл впливає на майбутні сеанси. Ця інструкція є bootstrap агента за принципом best-effort; якщо ваше середовище має оновлювати Skills детерміновано, реалізуйте ту саму синхронізацію в довіреному хуку `SessionStart` або в інтеграції вашого MCP-клієнта.

## Де використовуються Skills

Наразі Skills мають двох споживачів:

* Сумісні зовнішні агенти виявляють і синхронізують увімкнені пакети через Flowglad MCP, а потім автоматично зіставляють їх або викликають за назвою.
* Automations закріплюють точну опубліковану ревізію Skill як ресурс коду OWS `skill-revision`. Automation вибирає шлях пакета та точку входу; кроки агента отримують лише ті Skills, які авторизовані запечатаним набором можливостей запуску.

Перший шлях надає зовнішньому агенту повторно використовувані інструкції. Другий надає незмінний код і допоміжні файли для повторюваного запуску Automation. Опубліковані Skills діють у межах усієї організації, тому авторизована Automation може вибрати ту саму ревізію Skill у будь-якому Space. Automation-споживач і її запуски залишаються у володінні свого Space; вибір Skill не змінює цієї межі.

## Створення та підтримка Skills

Відкрийте **organization menu** → **Skills** → **New Skill**. На вкладці **Skill** введіть **Name**, **Slug**, необов'язковий **Description** і повторно використовувані інструкції в **Markdown**. Використовуйте вкладку **Files** для будь-яких допоміжних файлів пакета, а потім виберіть **Create Skill**.

Slug складається з малих літер, цифр і дефісів, починається з літери або цифри та є тим, що користувачі вводять після `/`.

Створення або редагування Skill створює чернетку. На сторінці відомостей про Skill зміни зберігаються автоматично; виберіть **Publish Draft**, щоб перевірити й опублікувати чернетку. Якщо перевірка не вдалася, скористайтеся показаною діагностикою, щоб виправити чернетку, і опублікуйте її знову.

Використовуйте **History**, щоб переглядати ревізії, відновлювати замінену ревізію або відхиляти змінювану чернетку, якщо ці дії доступні. **Disable Skill** вилучає його з виявлення зовнішніми агентами та з розв'язання в Automations без видалення історії ревізій; **Enable Skill** знову робить його доступним.

## Створення або редагування Skill за допомогою MCP

Для створення з пріоритетом пакета використовуйте підключений зовнішній MCP-клієнт. Викличте `skills.get` перед редагуванням наявного Skill. Використовуйте `skills.create` для нового пакета або `skills.create_candidate` для ревізії на основі поточної активної ревізії.

Невеликі пакети можна передавати inline. Для більших пакетів викличте `skills.create_package_upload_session`, завантажте запитані об'єкти та завершіть за допомогою `skills.finalize_package_upload_session`. Якщо перевірку було відкладено, викличте `skills.publish_revision`. Опитуйте `skills.get`, щоб отримати прийнятий запит життєвого циклу та результат його перевірки або просування.

Публікація Skill не створює, не змінює й не активує Automation; за потреби явно використовуйте життєвий цикл Automation через MCP.

## Почніть із шаблону Skill

Сторінка **Skills** містить **Skill Templates**. Шукайте або фільтруйте каталог, переглядайте шаблон і виберіть **Copy Skill**. Копія стає Skill організації, який можна редагувати й публікувати, як і будь-який інший Skill.

## Skills і Automations

Skill визначає, як виконувати повторно використовувану роботу. Він не вирішує, коли ця робота запускається.

Використовуйте Automation, коли роботу потрібно запускати вручну, за розкладом або у відповідь на подію. Automation може закріпити одну чи кілька ревізій Skill, щоб та сама реалізація повторно використовувалася в різних запусках.


## Related topics

- [MCP](/docs/uk/mcp-server.md)
- [Automations](/docs/uk/automations.md)
- [Ласкаво просимо](/docs/uk/agents/introduction.md)


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