​

Навыки Велеса: подробный справочник

​

Что такое навык в Велес

• заголовок с названием и описанием;
• дополнительные метаданные;
• инструкции в формате Markdown для Велеса.
• при необходимости вспомогательные файлы: скрипты, справочные материалы и ресурсы.

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

​

Где Велес ищет навыки

​

1. Навыки активной личности

• <workspace>/personalities/<id>/skills/<имя-навыка>/SKILL.md

​

2. Навыки рабочей области

• <workspace>/skills/<имя-навыка>/SKILL.md

​

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

• veles/skills/<имя-навыка>/SKILL.md

​

Как добавить навык

python veles/skills/skill-creator/scripts/init_skill.py <имя-навыка> --path <workspace>/skills

python veles/skills/skill-creator/scripts/init_skill.py <имя-навыка> --path <workspace>/personalities/<id>/skills

python veles/skills/skill-creator/scripts/package_skill.py <путь-к-каталогу-навыка>

npx --yes clawhub@latest install <slug> --workdir <workspace>

​

Программный каталог навыков

• personalities.skills.catalog

• GET /api/skills
• POST /api/skills/translate

​

Как навыки попадают в контекст Велеса

​

1. Краткое описание (summary) всех навыков

• название;
• описание;
• путь к файлу SKILL.md;
• статус доступности;
• сведения о недостающих технических требованиях (если есть).

​

2. Загрузка полного текста SKILL.md по мере необходимости

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

​

3. Навыки с постоянной доступностью (always-on)

​

Как определяется доступность навыка

• наличие необходимых программ (CLI) в системном пути (PATH);
• наличие обязательных переменных окружения;
• иные предварительные условия (prerequisites), указанные в описании.

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

​

Какие навыки доступны сейчас

• deep-research
• perplexity-search
• memory
• onboarding
• cron
• weather
• summarize
• skill-creator
• tmux
• documents
• report-authoring

• Навык: Глубокое исследование
• Навык: Память
• Навык: Первичная настройка
• Навык: Cron (Расписание)
• Навык: Entrez Search (NCBI)
• Навык: FDA Database
• Набор медицинских навыков
• Набор навыков консультанта по питанию
• Правовая проверка управления средствами НПФ
• Финансовые навыки для НПФ
• Навык: Perplexity Search
• Навык: Погода
• Навык: Summarize (Выжимки)
• Навык: GitHub
• Навык: GitLab
• Навык: Google Workspace
• Навык: ClawHub (Каталог)
• Навык: ALOR Mail
• Навык: ALOR Calendar
• Навык: Битрикс24 ALOR
• Навык: Контур.Толк ALOR
• Навык: Teamly ALOR
• Навык: Tmux (Терминал)
• Навык: Создание навыков
• Навык: Веб-разработка
• Навык: Создание документов DOCX
• Навык: Подготовка содержательных отчётов

​

Краткий каталог навыков

​

deep-research

• проведение полноценных глубоких исследований по заданным темам;
• многошаговый процесс (pipeline) с подготовкой итогового структурированного отчёта.

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

​

perplexity-search

• специализированный сценарий поиска в сети через OpenRouter и использование модели perplexity/sonar-pro.

​

memory

• инструкции для Велеса по работе с долгосрочной памятью, файлом MEMORY.md, сводками и механизмами припоминания (recall).

• является одним из ключевых навыков системы;
• работает в режиме постоянной доступности (always-on).

​

onboarding

• пошаговое знакомство с неопытным пользователем без требования самостоятельно править служебные файлы;
• разделение устойчивого профиля, долговременного контекста, личности агента и правил рабочей области;
• подготовка точного проекта изменений для USER.md, memory/MEMORY.md, выбранного SOUL.md и AGENTS.md.

• постоянно загружает только короткие правила запуска и безопасности, а подробную анкету — по запросу;
• не начинает опрос самовольно и не прерывает обычную задачу;
• предлагает варианты с объяснением последствий и позволяет пропустить вопрос;
• считает ответы самоописанием пользователя, не угадывает чувствительные признаки и не запрашивает секреты;
• сохраняет существующие содержательные инструкции и записывает изменения только после показа точного проекта и явного подтверждения;
• использует AGENTS.md во множественном числе и не создаёт неиспользуемый AGENT.md.

​

cron

• помощь в корректном использовании планировщика задач и расписаний.

​

entrez-search

• поиск литературы и биомедицинских записей через NCBI Entrez E-utilities;
• работа с PubMed, PMC, Gene, Protein, Nuccore, ClinVar, PubChem, MeSH и SNP;
• построение медицинских запросов с MeSH, publication type и date-фильтрами.

• ключ NCBI и адрес для идентификации запросов опциональны и хранятся как секреты skills.entrez-search.env.NCBI_API_KEY и skills.entrez-search.env.NCBI_EMAIL;
• отсутствие ключа не выключает навык, но оставляет обычный лимит запросов NCBI.

​

fda-database

• поиск официальной информации FDA/openFDA о лекарствах и таблетках;
• работа с label, NDC, recalls/enforcement, Drugs@FDA approvals, shortages, FAERS adverse events и substances/UNII;
• проверка medication safety facts до пациентских ответов.

• API-ключ openFDA опционален и хранится как секрет skills.fda-database.env.OPENFDA_API_KEY;
• сведения FDA относятся к США и не заменяют национальные реестры и инструкции;
• перед персональным советом о лекарствах навык требует memory_search, чтение docs/myhealth при наличии и многоисточниковую проверку;
• FAERS используется только как safety-signal источник, не как доказательство причинности или частоты событий.

​

Медицинский набор

• medical-symptom-navigation — история симптомов, оценка срочности и обсуждаемые диагностические возможности без окончательного диагноза;
• medical-lab-results — разбор результата по точной единице и референсному интервалу лаборатории;
• medication-reconciliation — сверка лекарств, добавок, аллергий и расхождений без назначения или изменения дозы;
• medical-evidence-review — поиск действующих рекомендаций, регуляторных сведений и подходящих научных исследований;
• medical-visit-preparation — хронология, краткая передача случая и вопросы к специалисту.

• новые навыки не требуют секретов или отдельных программ;
• правила экстренной помощи и конфиденциальности продублированы в SOUL.md, потому что отдельный навык может не загрузиться;
• entrez-search и fda-database дополняют набор как источники данных;
• FDA относится к США и не заменяет национальный регулятор;
• медицинская личность использует обычные механизмы истории и общей памяти Велеса; отдельная медицинская карта и изолированное хранилище не создаются.

​

Набор консультанта по питанию

• pp-nutrition — состав обычных продуктов, сравнение на общей основе и расчёт блюда по USDA FoodData Central;
• pp-open-food-facts — состав, аллергены и показатели упакованных продуктов по штрихкоду;
• medical-evidence-review и entrez-search — проверка значимых рекомендаций и поиск публикаций;
• medical-lab-results, medication-reconciliation и medical-symptom-navigation — узкие медицинские сценарии, когда вопрос выходит за пределы общей информации о питании.

• оба навыка содержат ограниченные скрипты на стандартной библиотеке Python и не требуют отдельных командных программ или дополнительных библиотек;
• ключ для Open Food Facts не нужен; необязательный бесплатный FDC_API_KEY хранится в зашифрованных секретах Велеса;
• адаптированные навыки разрешают только ограниченную работу с данными и не содержат собственный пищевой дневник, локальные файлы с ключами, вебхуки или изменение внешних записей;
• пищевая база не заменяет клинические рекомендации, а сведения Open Food Facts сверяются с упаковкой;
• личность использует общую рабочую область и память Велеса и не обещает анонимность или изоляцию.

​

npf-asset-management-legal-review

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

• справочник внутри навыка сохраняет предоставленный перечень из 62 позиций на 28 августа 2026 года, но не заменяет проверку официального текста;
• отсутствующий в справочнике источник можно использовать только с явной пометкой, не изменяя зафиксированный перечень молча;
• навык не требует секретов или отдельных программ;
• история и память не изолированы, адвокатская тайна не создаётся, а юридически значимые действия требуют отдельного прямого поручения.

​

Финансовый набор для НПФ

• npf-pension-asset-strategy — сводный разбор стратегии пенсионных активов;
• npf-alm-liquidity-scenarios — согласование активов и обязательств и сценарии ликвидности;
• npf-investment-risk-stress-testing — методы риска и стресс-сценарии;
• npf-reporting-quality-review — качество, определения и воспроизводимость отчётности;
• npf-issuer-investment-analysis — анализ эмитента и ценной бумаги;
• npf-market-scenario-analysis — макроэкономические и рыночные сценарии.

​

weather

• алгоритм получения актуальных данных о погоде и прогнозов.

​

summarize

• создание кратких пересказов содержимого ссылок, локальных файлов, PDF-документов и видео с YouTube.

​

github

• решение задач на GitHub через интерфейс командной строки gh и связанные автоматизированные процессы.

​

gitlab-skill

• работа с GitLab через программный интерфейс GitLab и команды git: проекты, задачи, запросы на слияние, ветки, коммиты и проверки.

• объявляет GITLAB_TOKEN как секрет навыка skills.gitlab-skill.env.GITLAB_TOKEN;
• GITLAB_HOST остаётся обычной настройкой, потому что адрес сервера не является секретом.

​

google-workspace

• работа с почтой Gmail, календарём, диском, контактами, таблицами и документами Google;
• пошаговая настройка доступа через OAuth 2.0 с обновлением токена;
• единый командный скрипт для чтения, поиска, создания и изменения данных после явного подтверждения пользователя.

• хранит файл клиента Google, токен и временное состояние авторизации в зашифрованном хранилище секретов Велеса;
• требует VELES_SECRETS_MASTER_KEY для записи и чтения локальных секретов;
• перед отправкой писем, созданием или удалением событий, изменением документов, таблиц и прав доступа требуется подтверждение пользователя;
• может использовать установленную программу gws, а без неё работает через библиотеки Google для Python.

​

clawhub

• поиск и установка новых навыков из открытого каталога.

​

alor-calendar

• чтение и управление Outlook/Exchange календарём ALOR через EWS;
• использование настроек и учетных данных из существующей конфигурации email-канала;
• просмотр, поиск и создание календарных событий после явного подтверждения пользователя.

• требует Python-пакеты exchangelib и python-dateutil;
• по умолчанию использует Europe/Moscow;
• операции изменения календаря требуют подтверждения, потому что меняют внешнюю систему.

​

alor-bitrix24

• чтение данных локального портала Битрикс24 ALOR;
• работа со сделками, контактами, компаниями, задачами, чатами, файлами и другими доступными разделами;
• подготовка и подтверждённое выполнение изменений через защищённый помощник.

• принимает только адрес https://portal.alorbroker.ru и отклоняет другой домен;
• использует только входящий вебхук;
• требует секреты skills.alor-bitrix24.env.B24_WEBHOOK_USER_ID и skills.alor-bitrix24.env.B24_WEBHOOK_CODE;
• хранит секреты вне config.json и подставляет их только на время ответа;
• требует локальный план и подтверждение перед изменением внешних данных;
• требует доступ среды Велеса к внутренней сети ALOR.

​

alor-ktalk

• поиск запланированных и прошедших встреч в пространстве Контур.Толка ALOR;
• получение материалов встречи: участников, записей, сообщений, опросов, заметок и досок;
• получение расшифровки, краткого пересказа, протокола и отчётов о посещении;
• безопасное сохранение текстовых материалов и явно запрошенных файлов в рабочую область.

• принимает только адрес https://alor.ktalk.ru и запрещает перенаправления;
• требует секрет skills.alor-ktalk.env.KTALK_API_KEY, который не записывается в config.json;
• использует только операции чтения и не предоставляет команд изменения данных Толка;
• делает одну совместимую попытку через заголовок X-Auth-Token: статья о персональном ключе не называет заголовок, а публичное описание программного интерфейса связывает этот заголовок с ключом пространства;
• не перебирает другие способы передачи секрета после ошибки авторизации;
• потоково сохраняет большие файлы, ограничивает размер и не перезаписывает существующий путь;
• никогда не передаёт ключ другому узлу, в том числе при перенаправлении загрузки;
• считает названия, описания, чаты, заметки и расшифровки недоверенными данными.

​

alor-teamly

• поиск и чтение пространств, деревьев и статей локальной базы знаний Teamly ALOR;
• вопросы помощнику Teamly только по корпоративным документам;
• подготовка и подтверждённое выполнение изменений в базе знаний.

• принимает только адрес https://teamly.alor.ru и отклоняет перенаправления или куки чужого домена;
• использует вход Teamly через службу каталогов, но не автоматизирует браузер и не копирует его куки;
• читает username, adDomainId и accountSlug из skills.entries.alor-teamly.config активного config.json;
• требует только один секрет навыка — TEAMLY_PASSWORD;
• хранит полученные куки сеанса под ключом skills.alor-teamly.session_json в зашифрованном хранилище Велеса;
• обновляет сеанс и после ответа 401 выполняет новый вход с секретами Велеса;
• требует явное подтверждение записи и отдельное подтверждение удаления;
• требует доступ среды Велеса к внутренней сети ALOR.

​

alor-mail

• чтение, поиск и отправка корпоративной почты ALOR через IMAP и SMTP;
• использование настроек из существующей конфигурации почтового канала;
• подготовка ответов и отправка писем после подтверждения пользователя.

• не выполняет разрушительные операции с письмами по умолчанию;
• берёт все параметры IMAP и SMTP только из channels.email в активном config.json;
• читает пароли только из локального зашифрованного хранилища Велеса;
• использует цели секретов channels.email.imapPassword и channels.email.smtpPassword;
• принимает для паролей только локальные SecretRef, а открытые строки и внешние источники отклоняет;
• использует обычный синтаксис поиска IMAP;
• присваивает исходящему письму Message-ID, сохраняет принятую SMTP копию в исходной IMAP-папке с признаком \Sent и строит заголовки ответа по UID родительского письма;
• считает ошибку сохранения копии после подтверждения SMTP частичным успехом и запрещает автоматическую повторную отправку.

​

skill-creator

• помощь в проектировании и корректной упаковке новых навыков. Полезен, если вы хотите добавить собственный сценарий в рабочую область (workspace).

​

tmux

• управление сессиями tmux для интерактивной или параллельной работы (актуально для Linux/macOS).

​

web-development

• руководство (guidance) по задачам создания и развития веб-проектов.

​

Чем навыки отличаются от инструментов на практике

​

Инструмент (Tool)

​

Навык (Skill)

​

Deep Research как особый случай

• большая продолжительность выполнения;
• высокая потребность во времени и ресурсах;
• необходимость предварительного уточнения темы;
• сложная структура процесса (не сводится к паре действий);
• результатом является отдельный аналитический документ.

​

Что важно для автора собственного навыка

• четко описывать контекст своего применения;
• опираться на существующие инструменты, не дублируя их логику;
• содержать информацию об ограничениях и типичных ошибках (anti-patterns);
• предоставлять Велесу понятный алгоритм действий;
• описывать необходимые предварительные условия (prerequisites).

​

Практические выводы

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

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

​

Итог

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