--- title: Скиллы в OpenCode: как создавать и использовать slug: opencode-skilly description: Скиллы в OpenCode: создание SKILL.md, структура, шаблоны и практические примеры. Как добавить навыки агента и использовать их в работе. keywords: [opencode скиллы, навыки opencode, SKILL.md, создать скилл, скиллы агента] h1: Скиллы в OpenCode: как создавать и использовать category: OpenCode tags: [opencode, скиллы, SKILL.md, навыки] date: 2026-08-20 image: /images/articles/opencode-skilly.webp image_alt: Скиллы в OpenCode — структура SKILL.md и примеры reading_time: ~8 мин author: Refertur canonical: https://ai-courses.refertur.net/articles/opencode-skilly/ faq: - q: Что такое скиллы в OpenCode? a: Скиллы в OpenCode — это файлы SKILL.md с инструкциями и шаблонами для выполнения конкретных задач: написание статей, ревью кода, анализ данных. Скилл описывает, когда его использовать, как выполнять задачу и в каком формате выводить результат. - q: Как создать скилл в OpenCode? a: Создать скилл в OpenCode можно, создав папку с именем скилла и файл SKILL.md внутри. В SKILL.md описываются: когда использовать, экспертиза, процесс, формат вывода, анти-паттерны и проверка качества. Скиллы кладутся в папку скиллов проекта или глобально. - q: Чем скилл отличается от агента? a: Скилл — это набор инструкций и экспертизы для выполнения задачи, агент — это роль с настроенными инструментами. Практическое отличие: скилл загружается в контекст когда нужен (экономит токены), агент всегда активен со своей ролью. Часто они работают вместе: агент вызывает нужный скилл. - q: Какие скиллы полезно создать в первую очередь? a: Полезные первые скиллы: ревью кода (проверка качества и безопасности), написание документации, тестирование, SEO-оптимизация контента, анализ данных, генерация отчётов. Начните с задачи, которую вы повторяете чаще всего. - q: Где хранятся скиллы OpenCode? a: Скиллы OpenCode хранятся в папке скиллов: глобально — ~/.config/opencode/skills/ (или ~/.claude/skills для Claude-совместимых), в проекте — .opencode/skills/. Каждый скилл — отдельная папка с файлом SKILL.md и дополнительными файлами. jsonld: {} --- # Скиллы в OpenCode: как создавать и использовать Скиллы в OpenCode превращают ИИ-агента в эксперта в ваших задачах: вы описываете процесс, экспертизу и формат результата один раз, а агент использует это каждый раз без ваших пояснений. В этом руководстве разберём, как создавать скиллы, как устроен SKILL.md и как встроить навыки в ежедневную работу. ## Что такое скилл Скилл (навык) — это Markdown-файл SKILL.md, который содержит: - Триггеры и описание — когда применять скилл - Экспертизу — правила и знания, которых нет у базовой модели - Процесс — чёткие шаги выполнения - Формат вывода — шаблоны и структуры результата - Анти-паттерны — чего избегать - Чек-лист качества — как проверить результат ## Структура SKILL.md ```markdown --- name: kebab-case-name description: > 2-3 предложения для модели: когда использовать, триггерные фразы, контекст. --- # Название скилла ## Когда использовать [конкретные фразы и контексты] ## Экспертиза и контекст [факты, правила, стандарты домена] ## Процесс [шаги: сделай X, потом Y] ## Формат вывода [шаблоны, структуры] ## Анти-паттерны [что НЕ делать] ## Проверка качества - [ ] критерий 1 - [ ] критерий 2 ``` ## Как создать скилл: пошагово ### Шаг 1: выберите папку - Глобально (для всех проектов): `~/.config/opencode/skills/` - В проекте: `.opencode/skills/` ### Шаг 2: создайте папку и файл ```bash mkdir -p ~/.config/opencode/skills/seo-writer ``` Создайте `SKILL.md` по шаблону выше. Пример скилла для SEO-статей: ```markdown --- 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 | Улучшение работы агента | ## Примеры использования скиллов ### Скилл для ревью кода ```markdown --- name: code-review description: > Проверяет код на баги, уязвимости и читаемость. Используй для фраз «проверь код», «code review». --- # Ревью кода ## Процесс 1. Прочитай все изменённые файлы 2. Найди: баги, проблемы безопасности, дублирование 3. Оцени читаемость и тесты 4. Выдай отчёт по приоритетам (P0-P2) ## Формат вывода | Приоритет | Файл | Проблема | Решение | ## Проверка качества - [ ] Каждая проблема имеет конкретное решение - [ ] Указаны строки и файлы ``` ### Скилл для отчётов ```markdown --- 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 для задачи, которую повторяете чаще всего, и агент будет выполнять её стабильно и качественно. Создадим набор скиллов для вашего бизнеса — напишите нам. --- *Отчёт создан: refertur@yandex.ru · [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) — ответим в течение часа.*