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

# Навык: Создатель навыков

> Как использовать этот навык для проектирования, создания и упаковки собственных навыков для Велес.

# Навык: Создатель навыков

`skill-creator` — это специализированный навык для разработки новых навыков и улучшения существующих.

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

***

## Когда он полезен

Основные сценарии использования:

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

***

## Что делает этот навык

Этот навык помогает рассматривать навык не как случайный текстовый файл, а как полноценный программный модуль (пакет).

Он предоставляет рекомендации по следующим вопросам:

* выбор оптимальной структуры папок;
* составление качественного описания в `SKILL.md`;
* определение необходимости использования внешних скриптов;
* использование справочных материалов (references);
* минимизация объема контекста для экономии ресурсов;
* финальная упаковка результата.

***

## Почему это выделено в отдельный навык

Процесс создания качественного навыка — задача нетривиальная.

Необходимо учитывать:

* условия активации (триггеры) навыка;
* правильное заполнение метаданных (frontmatter);
* механизмы пошаговой загрузки инструкций (progressive loading);
* разделение контента на основной (`SKILL.md`) и вспомогательный (каталог resources).

Именно поэтому здесь используется специальный направляющий навык (guidance), а не просто краткая инструкция.

***

## Когда можно обратиться к нему напрямую

Примеры запросов пользователя:

* «Создай навык для мониторинга курсов валют»
* «Помоги оформить новый навык для работы с API сервиса X»
* «Спроектируй универсальный навык для обработки PDF-документов»

***

## Что важно учитывать при разработке

* Качественный навык должен быть узкоспециализированным и практичным.
* Он должен эффективно использовать существующие инструменты (tools), а не дублировать их функции.
* Краткий и точный навык всегда работает лучше, чем длинный и расплывчатый.
* Перед созданием нового навыка нужно определить область действия: общий workspace-навык или навык конкретной личности.
* Если пользователь не указал область действия, `skill-creator` должен сначала спросить: это общий навык workspace или навык для конкретной личности?
* Общие навыки workspace располагаются по пути `workspace/skills/<имя-навыка>/SKILL.md`.
* Навыки конкретной личности располагаются по пути `workspace/personalities/<id>/skills/<имя-навыка>/SKILL.md` и подключаются только когда активна эта личность.
* Секретные значения нельзя записывать в навык; указывайте только имена env-переменных в `metadata`.
* Если переменная обязательна и без неё навык должен быть недоступен, используйте `{"veles":{"requires":{"env":["GH_TOKEN"]}}}`.
* Если ключ опционален, но должен появиться в панели секретов, используйте `{"veles":{"secrets":{"env":["NCBI_API_KEY"]}}}` — такой секрет не блокирует доступность навыка.

***

## Связанные страницы

* [Навыки Велеса: подробный справочник](/skills/reference_ru)
* [Навык: ClawHub (Каталог)](/skills/clawhub_ru)