Установка OpenCode Agent Skills

Что вы сможете сделать после урока

Установить Agent Skills plugin для OpenCode тремя различными способами
Проверить правильность установки плагина
Понять разницу между фиксированной версией и последней версией

Ваша текущая ситуация

Вы хотите, чтобы AI Agent умел повторно использовать навыки, но не знаете, как включить эту функцию в OpenCode. Система плагинов OpenCode выглядит довольно сложной, и вы боитесь неправильной конфигурации.

Когда использовать этот метод

Когда вам нужны следующие возможности AI Agent:

Повторное использование навыков между разными проектами (например, стандарты кода, шаблоны тестов)
Загрузка библиотеки навыков Claude Code
Следование AI определённому рабочему процессу

🎒 Подготовка перед началом

Проверка предварительных условий

Перед началом убедитесь, что:

Установлен OpenCode версии v1.0.110 или выше
Есть доступ к файлу конфигурации ~/.config/opencode/opencode.json (файл конфигурации OpenCode)

Основная идея

OpenCode Agent Skills — это плагин, публикуемый через npm. Установка проста: укажите имя плагина в файле конфигурации, и OpenCode автоматически загрузит и активирует его при запуске.

Сценарии использования трёх способов установки:

Способ	Сценарий использования	Плюсы и минусы
Базовая установка	Использование последней версии при каждом запуске	✅ Удобное автоматическое обновление ❌ Возможны критические изменения
Фиксированная версия	Необходимость стабильного производственного окружения	✅ Контролируемая версия ❌ Требуется ручное обновление
Локальная разработка	Необходимость кастомизации плагина или участия в разработке	✅ Гибкие изменения ❌ Требуется ручное управление зависимостями

Следуйте мне

Способ 1: Базовая установка (рекомендуется)

Это самый простой способ — при каждом запуске OpenCode будет проверять и загружать последнюю версию.

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

Шаги

Откройте файл конфигурации OpenCode

bash

# macOS/Linux
nano ~/.config/opencode/opencode.json

# Windows (используйте Notepad)
notepad %APPDATA%\opencode\opencode.json

Добавьте имя плагина в файл конфигурации

json

{
  "plugin": ["opencode-agent-skills"]
}

Если в файле уже есть другие плагины, просто добавьте в массив plugin:

json

{
  "plugin": ["other-plugin", "opencode-agent-skills"]
}

Сохраните файл и перезапустите OpenCode

Вы должны увидеть:

OpenCode перезапустится, в логе запуска отобразится успешная загрузка плагина
В диалоге с AI можно использовать инструменты типа get_available_skills

Способ 2: Установка фиксированной версии (для production)

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

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

Шаги

Откройте файл конфигурации OpenCode

bash

# macOS/Linux
nano ~/.config/opencode/opencode.json

Добавьте имя плагина с номером версии в файл конфигурации

json

{
  "plugin": ["[email protected]"]
}

Сохраните файл и перезапустите OpenCode

Вы должны увидеть:

OpenCode запустится с фиксированной версией v0.6.4
Плагин будет кэширован локально, повторная загрузка не требуется

Управление версиями

Плагины фиксированной версии кэшируются локально OpenCode, при обновлении версии требуется ручное изменение номера версии и перезапуск. Проверьте последнюю версию для обновления.

Способ 3: Локальная разработка (для контрибьюторов)

Если вы хотите кастомизировать плагин или участвовать в разработке, используйте этот способ.

Зачем В процессе разработки можно сразу видеть эффект изменений кода без ожидания публикации в npm.

Шаги

Клонируйте репозиторий в директорию конфигурации OpenCode

bash

git clone https://github.com/joshuadavidthomas/opencode-agent-skills ~/.config/opencode/opencode-agent-skills

Перейдите в директорию проекта и установите зависимости

bash

cd ~/.config/opencode/opencode-agent-skills
bun install

Почему Bun

Проект использует Bun как runtime и package manager, согласно полю engines в package.json требуется Bun >= 1.0.0.

Создайте символическую ссылку плагина

bash

mkdir -p ~/.config/opencode/plugin
ln -sf ~/.config/opencode/opencode-agent-skills/src/plugin.ts ~/.config/opencode/plugin/skills.ts

Вы должны увидеть:

~/.config/opencode/plugin/skills.ts указывает на ваш локальный код плагина
После изменения кода перезапустите OpenCode для применения изменений

Контрольная точка ✅

После завершения установки проверьте следующим образом:

Способ 1: Просмотр списка инструментов

Спросите AI в OpenCode:

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

Вы должны увидеть следующие инструменты:

use_skill - загрузить скилл
read_skill_file - прочитать файл скилла
run_skill_script - выполнить скрипт скилла
get_available_skills - получить список доступных скиллов

Способ 2: Вызов инструмента

Пожалуйста, вызовите get_available_skills, чтобы посмотреть, какие скиллы сейчас доступны?

Вы должны увидеть список скиллов (может быть пустым, но вызов инструмента прошёл успешно).

Способ 3: Просмотр логов запуска

Проверьте логи запуска OpenCode, должно быть что-то вроде:

[plugin] Loaded plugin: opencode-agent-skills

Частые проблемы

Проблема 1: Инструменты не появляются после запуска OpenCode

Возможные причины:

Ошибка формата JSON в файле конфигурации (пропущена запятая, кавычки и т.д.)
Слишком старая версия OpenCode (требуется >= v1.0.110)
Ошибка в написании имени плагина

Решение:

Проверьте синтаксис JSON с помощью инструмента валидации
Выполните opencode --version для проверки версии
Убедитесь, что имя плагина opencode-agent-skills (обратите внимание на дефисы)

Проблема 2: Обновление фиксированной версии не сработало

Причина: Плагины фиксированной версии кэшируются локально, после обновления номера версии требуется очистка кэша.

Решение:

Измените номер версии в файле конфигурации
Перезапустите OpenCode
Если всё ещё не работает, очистите кэш плагинов OpenCode (местоположение зависит от вашей системы)

Проблема 3: Изменения после локальной установки для разработки не применяются

Причина: Ошибка символической ссылки или неустановленные зависимости Bun.

Решение:

Проверьте, правильно ли создана символическая ссылка:
bash
```
ls -la ~/.config/opencode/plugin/skills.ts
```
Должно указывать на ~/.config/opencode/opencode-agent-skills/src/plugin.ts
Убедитесь, что зависимости установлены:
bash
```
cd ~/.config/opencode/opencode-agent-skills
bun install
```

Резюме урока

В этом уроке мы изучили три способа установки:

Базовая установка: добавить opencode-agent-skills в файл конфигурации, подходит для большинства пользователей
Установка фиксированной версии: добавить opencode-agent-skills@версия, подходит для production
Локальная установка для разработки: клонировать репозиторий и создать символическую ссылку, подходит для разработчиков

После установки можно проверить через список инструментов, вызов инструмента или логи запуска.

Анонс следующего урока

В следующем уроке мы изучим Создание вашего первого скилла.
Вы узнаете:
Структуру директории скиллов
Формат YAML frontmatter для SKILL.md
Как написать содержимое скилла

Приложение: Справка по исходному коду

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

Обновлено: 2026-01-24

Функция	Путь к файлу	Номер строки
Определение точки входа плагина	`package.json:18`	18
Основной файл плагина	`src/plugin.ts`	Весь файл
Конфигурация зависимостей	`package.json:27-32`	27-32
Требования к версии	`package.json:39-41`	39-41

Ключевая конфигурация:

main: "src/plugin.ts": файл точки входа плагина
engines.bun: ">=1.0.0": требования к версии runtime

Ключевые зависимости:

@opencode-ai/plugin ^1.0.115: SDK плагина OpenCode
@huggingface/transformers ^3.8.1: модель семантического соответствия
zod ^4.1.13: валидация Schema
yaml ^2.8.2: парсинг YAML

Установка OpenCode Agent Skills ​

Что вы сможете сделать после урока ​

Ваша текущая ситуация ​

Когда использовать этот метод ​

🎒 Подготовка перед началом ​

Основная идея ​

Следуйте мне ​

Способ 1: Базовая установка (рекомендуется) ​

Способ 2: Установка фиксированной версии (для production) ​

Способ 3: Локальная разработка (для контрибьюторов) ​

Контрольная точка ✅ ​

Частые проблемы ​

Проблема 1: Инструменты не появляются после запуска OpenCode ​

Проблема 2: Обновление фиксированной версии не сработало ​

Проблема 3: Изменения после локальной установки для разработки не применяются ​

Резюме урока ​

Анонс следующего урока ​

Приложение: Справка по исходному коду ​

Установка OpenCode Agent Skills

Что вы сможете сделать после урока

Ваша текущая ситуация

Когда использовать этот метод

🎒 Подготовка перед началом

Основная идея

Следуйте мне

Способ 1: Базовая установка (рекомендуется)

Способ 2: Установка фиксированной версии (для production)

Способ 3: Локальная разработка (для контрибьюторов)

Контрольная точка ✅

Частые проблемы

Проблема 1: Инструменты не появляются после запуска OpenCode

Проблема 2: Обновление фиксированной версии не сработало

Проблема 3: Изменения после локальной установки для разработки не применяются

Резюме урока

Анонс следующего урока

Приложение: Справка по исходному коду