Скиллы в 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
• Автономный режим OpenCode
• Управление контекстом
• Документация OpenCode (рус.)

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

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

• Что такое скиллы в OpenCode? — Файлы SKILL.md с инструкциями для задач.
• Как создать скилл? — Папка + SKILL.md с описанием, процессом и чек-листом.
• Чем скилл отличается от агента? — Скилл — инструкции по запросу, агент — всегда активная роль.
• Какие скиллы создать первыми? — Ревью кода, документация, SEO, тесты, отчёты.
• Где хранятся скиллы? — Глобально ~/.config/opencode/skills/ или в проекте .opencode/skills/.

Заключение

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

---

Отчёт создан: [email protected] · refertur.net · t.me/realhikaz · WhatsApp SEO, продвижение, разработка, сайты, веб-приложения, сервисы, калькуляторы, контент-маркетинг, каталоги, отчёты, аудиты — на заказ. Напишите нам в WhatsApp — ответим в течение часа.