Работа с навыками
Навыки — знания по запросу: учат VibeOS конкретным задачам, от ASCII-арта до GitHub PR. Это day-to-day гайд.
Техническая глубина — в Навыках.
Поиск навыков
В каждой установке есть bundled-набор. Посмотреть:
# In any chat session:
/skills
# Or from the CLI:
vibeos skills list
Компактный список имя + описание:
ascii-art Generate ASCII art using pyfiglet, cowsay, boxes...
arxiv Search and retrieve academic papers from arXiv...
github-pr-workflow Full PR lifecycle — create branches, commit...
plan Plan mode — inspect context, write a markdown...
excalidraw Create hand-drawn style diagrams using Excalidraw...
В поисках навыка
# Search by keyword
/skills search docker
/skills search music
Центр навыков
Официальные дополнительные навыки (более тяжелые или нишевые навыки, неактивные по умолчанию) доступны через Центр:
# Browse official optional skills
/skills browse
# Search the hub
/skills search blockchain
Использование навыка
Каждый установленный навык автоматически доступен как slash-команда. Просто введите имя:
# Load a skill and give it a task
/ascii-art Make a banner that says "HELLO WORLD"
/plan Design a REST API for a todo app
/github-pr-workflow Create a PR for the auth refactor
# Just the skill name (no task) loads it and lets you describe what you need
/excalidraw
Вы также можете активировать навыки посредством естественного разговора — попросите VibeOS использовать определенный навык, и он загрузит его с помощью инструмента skill_view.
Progressive Раскрытие информации
Skills использует шаблон загрузки с эффективным использованием токенов. Агент не загружает все сразу:
skills_list()— компактный список всех навыков (~3 тыс. токенов). Загружается при запуске сеанса.skill_view(name)— полный контент SKILL.md для одного навыка. Загружается, когда агент решает, что ему нужен этот навык.skill_view(name, file_path)— конкретный справочный файл в рамках навыка. Загружается только при необходимости.
Это означает, что навыки не требуют жетонов до тех пор, пока они не будут фактически использованы.
Установка из Hub
Официальные дополнительные навыки поставляются с VibeOS, но по умолчанию они неактивны. Установите их явно:
# Install an official optional skill
vibeos skills install official/research/arxiv
# Install from the hub in a chat session
/skills install official/creative/songwriting-and-ai-music
# Install a single-file SKILL.md directly from any HTTP(S) URL
vibeos skills install https://sharethis.chat/SKILL.md
/skills install https://example.com/SKILL.md --name my-skill
Что происходит:
- Каталог навыков копируется в
~/.vibeos/skills/ - Он появится в вашем выводе
skills_list - Он становится доступен по slash-команде
Установленные навыки вступают в силу в новых сеансах. Если вы хотите, чтобы он был доступен в текущем сеансе, используйте /reset, чтобы начать заново, или добавьте --now, чтобы немедленно аннулировать кэш подсказок (на следующем ходу будет стоить больше жетонов).
Проверка Установка
# Check it's there
vibeos skills list | grep arxiv
# Or in chat
/skills search arxiv
Навыки, предоставляемые плагином
Плагины могут объединять свои собственные навыки, используя имена в пространстве имен (plugin:skill). Это предотвращает конфликты имен со встроенными навыками.
# Load a plugin skill by its qualified name
skill_view("superpowers:writing-plans")
# Built-in skill with the same base name is unaffected
skill_view("writing-plans")
Навыки плагинов не перечислены в системной подсказке и не отображаются в skills_list. Они добровольны — загружайте их явно, если знаете, что плагин их предоставляет. При загрузке агент видит баннер со списком одноуровневых навыков из того же плагина.
Информацию о том, как добавить навыки в собственный плагин, см. в разделе [Создать плагин VibeOS → Пакет]. навыки](/guides/build-a-vibeos-plugin#bundle-skills).
Настройка параметров навыков
Некоторые навыки объявляют необходимую конфигурацию в своих фронтовая тема:
metadata:
vibeos:
config:
- key: tenor.api_key
description: "Tenor API key for GIF search"
prompt: "Enter your Tenor API key"
url: "https://developers.google.com/tenor/guides/quickstart"
При первой загрузке навыка с конфигурацией VibeOS предложит вам ввести значения. Они хранятся в config.yaml в skills.config.*.
Управление конфигурацией навыков из CLI:
# Interactive config for a specific skill
vibeos skills config gif-search
# View all skill config
vibeos config show | grep '^skills\.config'
Создание собственного навыка
Skills — это просто markdown-файлы с YAML. Создание его занимает менее пяти минут.
1. Создайте Каталог
mkdir -p ~/.vibeos/skills/my-category/my-skill
2. Напишите SKILL.md
---
name: my-skill
description: Brief description of what this skill does
version: 1.0.0
metadata:
vibeos:
tags: [my-tag, automation]
category: my-category
---
# My Skill
## When to Use
Use this skill when the user asks about [specific topic] or needs to [specific task].
## Procedure
1. First, check if [prerequisite] is available
2. Run `command --with-flags`
3. Parse the output and present results
## Pitfalls
- Common failure: [description]. Fix: [solution]
- Watch out for [edge case]
## Verification
Run `check-command` to confirm the result is correct.
3. Добавить справочные файлы (необязательно)
Skills может включать вспомогательные файлы, которые агент загружает по требованию:
my-skill/
├── SKILL.md # Main skill document
├── references/
│ ├── api-docs.md # API reference the agent can consult
│ └── examples.md # Example inputs/outputs
├── templates/
│ └── config.yaml # Template files the agent can use
└── scripts/
└── setup.sh # Scripts the agent can execute
Ссылка на них в вашем SKILL.md:
For API details, load the reference: `skill_view("my-skill", "references/api-docs.md")`
4. Проверьте
Начните новый сеанс и попробуйте свои навыки:
vibeos chat -q "/my-skill help me with the thing"
Навык появляется автоматически — регистрация не требуется. Добавьте его ~/.vibeos/skills/, и он станет доступен.
Агент также может сам создавать и обновлять навыки с помощью skill_manage. После решения сложной задачи VibeOS может предложить сохранить этот подход в качестве навыка для следующего раза.
Per-Platform Skill Управление
Контролируйте, какие навыки доступны на каких платформах:
vibeos skills
Откроется интерактивное окно TUI, где вы можете включить или отключить навыки для каждой платформы (CLI, Telegram, Discord и т. д.). Полезно, если вы хотите, чтобы определенные навыки были доступны только в определенных контекстах — например, отключите навыки разработки Telegram.
Skills vs Память
Оба являются постоянными во всех сеансах, но служат разным целям:
| Навыки | Память | |
|---|---|---|
| Что | Процедурные знания — как делать | Фактическое знание — что такое вещи |
| Когда | Загружается по требованию, только при необходимости | Автоматически добавляется в каждый сеанс |
| Размер | Может быть большим (сотни строк) | Должен быть компактным (только ключевые факты) |
| Стоимость | Ноль жетонов до загрузки | Небольшая, но постоянная стоимость токена |
| Примеры | «Как развернуть в Kubernetes» | «Пользователь предпочитает темный режим, живет в PST» |
| Кто создаёт | Вы, агент, или установили из Hub | Агент, на основе разговоров |
Практическое правило: Если вы поместите это в справочный документ, это навык. Если бы вы записали это на стикер, то это память.
Советы
Сосредоточьтесь на навыках. Навык, который пытается охватить «все». DevOps» будет слишком длинным и слишком расплывчатым. Навык, который включает в себя «развертывание приложения Python на Fly.io», достаточно специфичен, чтобы быть действительно полезным.
Позвольте агенту создавать навыки. После сложной многоэтапной задачи VibeOS часто предлагает сохранить этот подход как навык. Скажите «да» — эти навыки, созданные агентом, отражают точный рабочий процесс, включая ловушки, обнаруженные на этом пути.
Используйте категории. Организуйте навыки в подкаталогах (~/.vibeos/skills/devops/, ~/.vibeos/skills/research/ и т. д.). Это обеспечивает управляемость списка и помогает агенту быстрее находить подходящие навыки.
Обновляйте навыки, когда они устаревают. Если вы используете навык и столкнулись с проблемами, не охваченными им, скажите VibeOS, чтобы он обновил навык, используя то, что вы узнали. Навыки, которые не поддерживаются, становятся пассивами.
Полную справку по навыкам — поля заголовка, условную активацию, внешние каталоги и многое другое — см. в разделе [Навыки] Система](/user-guide/features/skills).