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

# Навыки

> Просмотр, публикация, предоставление доступа и поддержка повторно используемых инструкций Craft

Навыки объединяют повторно используемые инструкции и вспомогательные файлы,
которые учат Craft выполнять определённый вид работы. Откройте **Craft → Навыки**, чтобы просматривать, загружать,
предоставлять доступ и управлять навыками.

> [!NOTE]
>
> Любой пользователь может загрузить навык и управлять навыками, которыми он владеет или которые может редактировать.
> **Менеджер группы** также может управлять навыками, доступными группам, которыми он управляет.
> Администраторы могут просматривать и контролировать все пользовательские навыки, включая приватные личные.

## Библиотека навыков

| Тип | Откуда берётся | Что может сделать администратор |
| - | - | - |
| **Встроенный** | Поставляется и поддерживается Yahont | Просмотреть инструкции и определить отсутствующие зависимости. Встроенные навыки нельзя редактировать. |
| **Пользовательский** | Создан администратором или пользователем | Изменять, делиться, управлять файлами, включать и отключать, передавать право владения или удалять. |

Новые пользовательские навыки сначала приватны. Поделитесь навыком с людьми, группами или организацией,
когда им должны пользоваться другие.

### Встроенные навыки

| Навык | Доступность |
| - | - |
| **Презентации** | Доступен вместе с Craft и задаёт рабочий процесс создания и проверки файлов `.pptx`. |
| **Поиск по компании** | Доступен вместе с Craft и ищет по знаниям Yahont с учётом прав пользователя на документы. |
| **Браузер** | Доступен, если в развёртывании включена среда выполнения браузера. |
| **Генерация изображений** | Доступна после того, как администратор настроит поддерживаемую [модель изображений](https://docs.yahont.ai/admins/actions/image_generation.md). |

Недоступный встроенный навык остаётся видимым администраторам с указанием причины, по которой его нельзя использовать.
Настройте отсутствующую зависимость, а не загружайте пользовательский навык с тем же slug.

## Подготовка пользовательского навыка

Загружайте `SKILL.md` напрямую, если навыку не нужны вспомогательные файлы. Для навыка со скриптами,
примерами или другими вспомогательными файлами создайте папку с `SKILL.md` на верхнем уровне.
Перетащите папку в Yahont или загрузите её в виде ZIP-архива.

> [!NOTE]
>
> Для отдельного `SKILL.md` Yahont создаёт slug из поля `name` во frontmatter. Для папки slug становится именем папки.
> Для ZIP-архива slug — имя файла без `.zip`. Имена папок и ZIP-архивов должны начинаться со строчной буквы,
> содержать только строчные буквы, цифры и дефисы и быть не длиннее 64 символов. Slug должны быть уникальными.
> Если существующий навык уже использует slug, обновите этот навык или измените исходное имя до загрузки.

```text theme={null}
weekly-customer-update/
├── SKILL.md
├── examples/
│   └── finished-update.md
├── templates/
│   └── update-template.md
└── scripts/
    └── validate.py
```

Для загрузки ZIP-архива поместите `SKILL.md` в корень архива или прямо внутрь одной внешней папки.
Если используется внешняя папка, держите все файлы навыка внутри неё. Загружайте только один навык за раз.

`SKILL.md` должен начинаться с frontmatter YAML с непустыми именем и описанием. В описании должно быть указано,
когда Craft следует выбирать этот навык.

```md theme={null}
---
name: weekly-customer-update
description: Create a weekly customer update from account activity and meeting notes.
---

# Weekly customer update

1. Summarize material changes since the previous update.
2. Separate decisions, risks, and next steps.
3. Name an owner and due date for each next step.
4. Follow `templates/update-template.md`.
5. Run `scripts/validate.py` before returning the final file.
```

### Требования к набору

| Требование | По умолчанию |
| - | - |
| Slug | Формируется из названия навыка, если он написан в Yahont или загружен как `SKILL.md`; иначе — имя папки или имя ZIP-файла без `.zip`. |
| Корневые инструкции | Один `SKILL.md` в UTF-8 с корректным frontmatter YAML в корне навыка. |
| Навыков за загрузку | Один. |
| Максимальный размер файла | 25 МБ на файл в распакованном наборе. |
| Максимальный размер набора | 100 МБ всего. |

Операторы с самостоятельным размещением могут изменить ограничения размера с помощью `SKILL_BUNDLE_PER_FILE_MAX_BYTES` и
`SKILL_BUNDLE_TOTAL_MAX_BYTES`.

Загрузка отклоняется, если в наборе есть небезопасные пути, символические ссылки, файлы с окончанием `.template`,
отсутствует или некорректен frontmatter, недопустим источник slug,
дублируется slug навыка или slug зарезервирован встроенным навыком или приложением.

## Проверка навыка перед публикацией

Относитесь к набору навыка как к коду и политике, а не только как к тексту промпта.
Craft может выполнять скрипты и команды, включённые в архив.

| Область проверки | Что проверить |
| - | - |
| **Назначение и выбор** | Название и описание чётко определяют, когда навык следует и не следует использовать. |
| **Инструкции** | Рабочий процесс ограничен, внутренне согласован и не предписывает Craft обходить одобрения или политику организации. |
| **Скрипты** | Каждый исполняемый файл ожидаем, читаем и безопасен для запуска на данных пользователя или компании. |
| **Внешний доступ** | В наборе нет встроенных токенов, а для сервисов с авторизацией используется настроенное приложение. |
| **Примеры и шаблоны** | Включённые файлы не содержат конфиденциальных данных и отражают качество, которого ожидают пользователи. |
| **Обработка результата** | Навык указывает ожидаемый формат и записывает готовые материалы в понятное место, например `outputs/`. |

> [!WARNING]
>
> Никогда не публикуйте набор, содержащий пароли, API-ключи, токены OAuth,
> приватные сертификаты или рабочие учётные данные. Файлы навыка копируются в песочницы пользователей,
> у которых есть доступ к навыку.
> Для авторизованного доступа к внешним сервисам используйте [приложения](https://docs.yahont.ai/admins/plugins/craft_apps.md).

## Публикация навыка

Администраторы и менеджеры групп создают навыки тем же процессом создания личных навыков, что и остальные пользователи.
Новый навык принадлежит создателю и сначала приватен.
Публикация означает проверку навыка и последующее предоставление доступа нужной аудитории.

> [!NOTE]
>
> Предоставить доступ к навыку всей организации может только его автор или администратор. Удалить можно любой навык,
> которым вы владеете или который можете редактировать, а администраторы могут удалить любой пользовательский навык.

**1. Создайте личный навык**

Откройте **Craft → Навыки** и нажмите **Создать навык**. Выберите **Создать с нуля**, чтобы написать навык в Yahont,
или **Загрузить навык**, чтобы импортировать `SKILL.md`, ZIP-архив или папку навыка.
Заполните редактор и нажмите **Создать**.

**2. Проверьте навык**

Проверьте название, описание, отображаемые инструкции и дерево вспомогательных файлов. Убедитесь, что Craft поймёт,
когда использовать навык, и что каждый включённый файл ожидаем.

**3. Выберите, кто может им пользоваться**

Выберите **Изменить доступ** и предоставьте доступ «Просмотр» конкретным пользователям, группам или организации.
Используйте доступ «Редактор» только для тех, кто отвечает за поддержку.

**4. Проверьте с целевой аудиторией**

Запустите сессию Craft от имени пользователя из целевой аудитории,
выберите навык и проверьте типичные входные данные, случаи отсутствия данных и итоговый результат.

## Выбор прав общего доступа

| Область | Просмотр | Редактор |
| - | - | - |
| **Конкретные люди** | Выбранные пользователи могут использовать навык и просматривать его. | Выбранные пользователи также могут изменять навык и управлять им. |
| **Группы** | Члены выбранных групп могут использовать навык и просматривать его. | Члены также могут изменять навык и управлять им. |
| **Организация** | Все могут использовать навык и просматривать его. | Все могут изменять его и управлять им. Используйте только для намеренно совместных навыков. |

Редакторы могут менять инструкции и файлы, обновлять доступ в рамках своих прав,
включать и отключать навык и удалять его. Только владелец может передать право владения;
администратор может передать его после того,
как прежний владелец станет неактивным или иным образом перестанет быть владельцем.

> [!TIP]
>
> Предпочитайте для всей организации доступ **Просмотр**, а небольшую группу сопровождающих делайте **Редакторами**.
> Так навык остаётся широко доступным, а его поведение не становится широко изменяемым.

## Поддержка навыка

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

| Действие | Результат |
| - | - |
| **Изменить сведения** | Обновляет название, описание или инструкции Markdown и перезаписывает `SKILL.md` в сохранённом наборе. |
| **Добавить файлы** | Добавляет файлы, папки или содержимое распакованного ZIP-архива. Файл по существующему пути заменяет сохранённый файл. |
| **Удалить файлы** | Удаляет вспомогательный файл из набора. `SKILL.md` удалить нельзя. |
| **Заменить содержимое** | Загрузка содержимого с `SKILL.md` после подтверждения заменяет название, описание, инструкции и весь набор. |
| **Отключить** | Не позволяет Craft использовать навык, не удаляя его конфигурацию и общий доступ. |
| **Изменить доступ** | Меняет, кто может просматривать навык или поддерживать его. |
| **Передать владение** | Назначает ответственность другому активному обычному пользователю. |
| **Удалить** | Безвозвратно удаляет навык и его сохранённый набор. |

Изменения синхронизируются с затронутыми работающими песочницами.
Уже выполняющийся шаг мог загрузить прежние инструкции, поэтому проверяйте важные изменения в новом шаге или сессии,
прежде чем объявлять о них.

### Владение

У каждого пользовательского навыка один владелец. Владелец может передать его другому активному обычному пользователю.
Если право владения освободилось из-за неактивности владельца, администратор может открыть навык и передать его.

Не передавайте право владения ботам, сервисным аккаунтам, аккаунтам с ограниченными правами и неактивным пользователям.

## Устранение неполадок

> [accordion] Набор навыка не загружается
>
> Убедитесь, что в загрузке один навык. `SKILL.md` должен лежать на верхнем уровне папки.
> В ZIP-архиве поместите его в корень архива или прямо внутрь одной внешней папки. Проверьте,
> что он в кодировке UTF-8 и начинается с корректного YAML с непустыми полями `name` и `description`.
> Для отдельного `SKILL.md` убедитесь, что `name` содержит хотя бы одну букву или цифру.
> Иначе проверьте имя папки или ZIP-архива.
> Проверьте ограничения набора и удалите символические ссылки и небезопасные пути.

> [accordion] Встроенный навык недоступен
>
> Откройте его предпросмотр, чтобы прочитать причину недоступности.
> Настройте генерацию изображений для навыка изображений или попросите оператора развёртывания проверить среду
> выполнения браузера для навыка «Браузер». Встроенные навыки нельзя заменить или включить из редактора навыков.

> [accordion] Пользователи не находят навык, которым поделились
>
> Убедитесь, что навык включён, а у пользователя или его группы есть доступ «Просмотр» или «Редактор».
> Если доступ предоставлен во время активной сессии, начните новый шаг или сессию и снова проверьте список выбора.

> [accordion] Craft не выбирает навык автоматически
>
> Перепишите описание, указав охватываемые задачи и результаты конкретнее.
> Проверьте снова и попросите пользователей выбирать навык явно, когда нужно строго следовать рабочему процессу.

> [accordion] Бывший сотрудник по-прежнему владеет навыком
>
> После того как аккаунт станет неактивным, администратор может открыть навык,
> выбрать **Изменить доступ** и передать освободившееся право владения активному обычному пользователю.

> [card] [Навыки для пользователей](https://docs.yahont.ai/overview/core_features/craft_skills.md)
>
> Покажите пользователям, как находить, выбирать, создавать и дорабатывать навыки.

> [card] [Управление приложениями](https://docs.yahont.ai/admins/plugins/craft_apps.md)
>
> Настройте авторизованный доступ и политики действий для внешних сервисов.


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