Скиллы в OpenCode: как создавать и использовать

Скиллы в OpenCode превращают ИИ-агента в эксперта в ваших задачах: вы описываете процесс, экспертизу и формат результата один раз, а агент использует это каждый раз без ваших пояснений. В этом руководстве разберём, как создавать скиллы, как устроен SKILL.md и как встроить навыки в ежедневную работу.

Что такое скилл

Скилл (навык) — это Markdown-файл SKILL.md, который содержит:

Триггеры и описание — когда применять скилл

Экспертизу — правила и знания, которых нет у базовой модели

Процесс — чёткие шаги выполнения

Формат вывода — шаблоны и структуры результата

Анти-паттерны — чего избегать

Чек-лист качества — как проверить результат

Структура SKILL.md

---
name: kebab-case-name
description: >
  2-3 предложения для модели: когда использовать,
  триггерные фразы, контекст.
---

# Название скилла

## Когда использовать
[конкретные фразы и контексты]

## Экспертиза и контекст
[факты, правила, стандарты домена]

## Процесс
[шаги: сделай X, потом Y]

## Формат вывода
[шаблоны, структуры]

## Анти-паттерны
[что НЕ делать]

## Проверка качества
- [ ] критерий 1
- [ ] критерий 2

Как создать скилл: пошагово

Шаг 1: выберите папку

Глобально (для всех проектов): `~/.config/opencode/skills/`

В проекте: `.opencode/skills/`

Шаг 2: создайте папку и файл

mkdir -p ~/.config/opencode/skills/seo-writer

Создайте `SKILL.md` по шаблону выше. Пример скилла для SEO-статей:

---
name: seo-writer
description: >
  Пишет SEO-статьи: исследование ключей, структура H1-H4,
  микроразметка, FAQ. Используй для контента под поиск.
---

# SEO-писатель

## Когда использовать
«напиши SEO-статью», «статья под ключ», «контент для сайта»

## Процесс
1. Определи ключи (ВЧ в title/H1, СЧ/НЧ в подзаголовках)
2. Построй структуру H1→H4
3. Напиши текст: ответ в первых 100 символах
4. Добавь таблицы, списки, FAQ (минимум 5 вопросов)
5. Сформируй JSON-LD (Article + FAQPage)

## Формат вывода
Markdown с frontmatter: title, description, keywords, faq

## Проверка качества
- [ ] Длина ≥ 4000 символов
- [ ] Ключи в title, H1, первом абзаце, FAQ
- [ ] Валидный JSON-LD

Шаг 3: используйте

Агент сам определит, когда применить скилл по описанию, или вы можете явно попросить: «используй скилл seo-writer для статьи о нейропоиске».

Категории скиллов

Тип скилла	Пример	Назначение
Контент	seo-writer, copywriter	Тексты, статьи, посты
Разработка	code-review, test-designer	Код, тесты, ревью
Анализ	analyst, fact-checker	Исследования, проверка
Автоматизация	pipeline, orchestrator	Процессы и воркфлоу
Мета	skill-factory, quality-gate	Улучшение работы агента

Примеры использования скиллов

Скилл для ревью кода

---
name: code-review
description: >
  Проверяет код на баги, уязвимости и читаемость.
  Используй для фраз «проверь код», «code review».
---

# Ревью кода

## Процесс
1. Прочитай все изменённые файлы
2. Найди: баги, проблемы безопасности, дублирование
3. Оцени читаемость и тесты
4. Выдай отчёт по приоритетам (P0-P2)

## Формат вывода
| Приоритет | Файл | Проблема | Решение |

## Проверка качества
- [ ] Каждая проблема имеет конкретное решение
- [ ] Указаны строки и файлы

Скилл для отчётов

---
name: report-generator
description: >
  Генерирует структурированные отчёты: факты, выводы,
  рекомендации. Используй для «сделай отчёт», «резюме анализа».
---

# Генератор отчётов

## Процесс
1. Собери факты и цифры из источников
2. Раздели: факты / интерпретации / рекомендации
3. Укажи уровень уверенности по каждому выводу
4. Сформулируй следующие шаги

## Формат вывода
- Резюме (3-5 строк)
- Таблица ключевых метрик
- Рекомендации с приоритетами

Эти два скилла покрывают самые частые запросы: проверку кода и подготовку отчётов. Добавьте их в проект — и агент начнёт выдавать структурированный результат без дополнительных пояснений.

Советы по созданию эффективных скиллов

1. **Описание — самое важное:** от него зависит, когда агент применит скилл. Пишите конкретные триггеры.

2. **Процесс вместо размышлений:** «сделай X, потом Y» лучше, чем «подумай о X».

3. **Примеры внутри скилла:** 1-2 мини-примера ускоряют обучение модели.

4. **Проверка качества:** чек-лист обязателен — агент сам себя проверит.

5. **Начинайте с малого:** один скилл на одну повторяющуюся задачу.

Таблица: скиллы vs агенты

Параметр	Скилл	Агент
Что это	Инструкции + экспертиза	Роль + инструменты
Когда активен	При загрузке в контекст	Всегда в сессии
Экономия токенов	Да (загружается по запросу)	Нет (контекст всегда)
Инструменты	Зависят от агента	Настроены в агенте
Пример	SEO-шаблон для статей	code-reviewer с доступом к bash

Что дальше

[Создание агентов в OpenCode](/articles/opencode-agenty/)

[Автономный режим OpenCode](/articles/opencode-avtonomnyj-rezhim/)

[Управление контекстом](/articles/opencode-kontekst/)

[Документация OpenCode (рус.)](/docs/overview/)

Следующие шаги

Часто задаваемые вопросы

Что такое скиллы в OpenCode? — Файлы SKILL.md с инструкциями для задач.

Как создать скилл? — Папка + SKILL.md с описанием, процессом и чек-листом.

Чем скилл отличается от агента? — Скилл — инструкции по запросу, агент — всегда активная роль.

Какие скиллы создать первыми? — Ревью кода, документация, SEO, тесты, отчёты.

Где хранятся скиллы? — Глобально ~/.config/opencode/skills/ или в проекте .opencode/skills/.

Заключение

Скиллы — самый быстрый способ сделать OpenCode экспертом в вашей области. Напишите один SKILL.md для задачи, которую повторяете чаще всего, и агент будет выполнять её стабильно и качественно. Создадим набор скиллов для вашего бизнеса — напишите нам.

---

*Отчёт создан: [email protected] · [refertur.net](https://refertur.net) · [t.me/realhikaz](https://t.me/realhikaz) · [WhatsApp](https://wa.me/+77054384888)*

*SEO, продвижение, разработка, сайты, веб-приложения, сервисы, калькуляторы, контент-маркетинг, каталоги, отчёты, аудиты — на заказ. Напишите нам в [WhatsApp](https://wa.me/+77054384888?text=%D0%97%D0%B4%D1%80%D0%B0%D0%B2%D1%81%D1%82%D0%B2%D1%83%D0%B9%D1%82%D0%B5%2C%20%D1%85%D0%BE%D1%87%D1%83%20%D0%B7%D0%B0%D0%BA%D0%B0%D0%B7%D0%B0%D1%82%D1%8C%20%D1%81%D0%B5%D0%BE) — ответим в течение часа.*