> ## 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 для слэш-команды, описание и инструкции, написанные в 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 добавить соответствующий блок в собственный файл пользовательских инструкций. Просмотрите предложенное изменение перед его принятием, поскольку этот файл влияет на будущие сессии. Инструкция — это начальная загрузка агента по принципу 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

Откройте **меню организации** → **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-клиент. Перед редактированием существующего Skill вызовите `skills.get`. Используйте `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/ru/mcp-server.md)
- [Automations](/docs/ru/automations.md)
- [Добро пожаловать](/docs/ru/agents/introduction.md)


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