Skip to main content

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.

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

Это подробная страница для тех, кто хочет понимать внутреннюю механику работы навыков в Велес. Если вам нужно простое объяснение без технических деталей, начните со статьи Навыки Велеса: простое объяснение. Если вас интересует практический алгоритм проведения глубокого исследования, откройте Глубокое исследование (Deep Research).

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

В текущей реализации навык — это директория с файлом SKILL.md, который содержит:
  • заголовок (frontmatter) с названием и описанием;
  • дополнительные метаданные;
  • инструкции в формате markdown для Велеса.
Идея заключается в том, что навык не является отдельным инструментом. Это слой инструкций, работающий поверх системы инструментов (tool-системы). То есть навык говорит Велесу:
  • в каких ситуациях применять данный сценарий;
  • какой именно алгоритм действий использовать;
  • какие ограничения следует учитывать;
  • какие инструменты задействовать;
  • каких действий следует избегать.

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

Велес загружает навыки из двух основных источников:

​
1. Навыки рабочей области (навыки рабочей области)

Это каталог проекта:
  • workspace/skills/<имя-навыка>/SKILL.md
Такие навыки имеют приоритет. Если в рабочей области (workspace) существует навык с тем же именем, что и встроенный, будет использована именно версия из workspace.

​
2. Встроенные навыки (Built-in skills)

Это стандартный каталог фреймворка:
  • veles/skills/<имя-навыка>/SKILL.md
Именно здесь хранятся базовые навыки, поставляемые вместе с проектом.

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

В процессе работы предусмотрено несколько уровней интеграции:

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

При формировании системного промпта (system prompt) Велес добавляет сводку доступных навыков:
  • название;
  • описание;
  • путь к файлу SKILL.md;
  • статус доступности;
  • сведения о недостающих технических требованиях (если есть).
Это не полный текст навыков, а обзорная информация, чтобы Велес понимал общие возможности системы.

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

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

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

Некоторые навыки могут быть помечены параметром always: true. В этом случае их содержимое попадает в активный контекст сразу при условии доступности навыка. В текущем встроенном наборе так работает навык memory (память).

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

Навык может физически присутствовать на диске, но считаться недоступным для использования. Велес проверяет его требования через метаданные:
  • наличие необходимых программ (CLI) в системном пути (PATH);
  • наличие обязательных переменных окружения;
  • иные предварительные условия (prerequisites), указанные в описании.
Практические последствия:
  • один и тот же навык может работать у одного пользователя и быть недоступен у другого;
  • сводка навыков в промпте может указывать на существование сценария, который временно не готов к запуску;
  • работоспособность многих навыков напрямую зависит от конфигурации локального окружения.

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

В основном каталоге veles/skills/ представлены следующие направления:
  • deep-research
  • perplexity-search
  • memory
  • cron
  • weather
  • summarize
  • github
  • clawhub
  • skill-creator
  • tmux
  • web-development
Ниже приведено краткое описание каждого. Быстрые ссылки на страницы навыков:

​
Краткий каталог встроенных навыков

​
deep-research

Назначение:
  • проведение полноценных глубоких исследований по заданным темам;
  • многошаговый процесс (pipeline) с подготовкой итогового структурированного отчёта.
Особенности:
  • требует четко сформулированной темы исследования;
  • рассчитан на продолжительную работу;
  • запускается как отдельный процесс, а не как быстрый ответ в чате.
Назначение:
  • специализированный сценарий поиска в сети через OpenRouter и использование модели perplexity/sonar-pro.

​
memory

Назначение:
  • инструкции для Велеса по работе с долгосрочной памятью, файлом MEMORY.md, сводками и механизмами припоминания (recall).
Особенность:
  • является одним из ключевых навыков системы;
  • работает в режиме постоянной доступности (always-on).

​
cron

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

​
weather

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

​
summarize

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

​
github

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

​
clawhub

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

​
skill-creator

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

​
tmux

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

​
web-development

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

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

Критическое различие заключается в следующем:

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

Это атомарная операция. Примеры: read_file, web_search, exec, session_history.

​
Навык (Skill)

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

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

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

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

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

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

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

​
Итог

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

​
навык-creator

Назначение:
  • помогает правильно проектировать и упаковывать новые skills.
Когда полезен:
  • вы хотите добавить собственный навык в workspace.

​
tmux

Назначение:
  • управление tmux-сессиями для интерактивной или параллельной работы.
Ограничения:
  • в основном имеет смысл на Linux/macOS;
  • зависит от наличия tmux.

​
web-development

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

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

Критическое различие заключается в следующем:

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

Это атомарная операция. Примеры: read_file, web_search, exec, session_history.

​
Навык (Skill)

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

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

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

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

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

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

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

​
Итог

В Велес навыки образуют интеллектуальный слой над инструментами:
  • инструменты предоставляют возможности для действий;
  • навыки задают логику и процесс выполнения;
  • встроенные навыки обеспечивают базовую функциональность «из коробки»;
  • навыки рабочей области позволяют адаптировать систему под специфику конкретного проекта или команды.
Если нужен обычный пользовательский взгляд, достаточно страницы Навыки Велеса: простое объяснение. Если нужен сложный исследовательский алгоритм, открывайте Глубокое исследование (Deep Research).