Skills в OpenCode: как дать агенту правила проекта

Если каждый новый чат начинается с «запусти тесты», «не меняй публичный API» и «сначала посмотри существующий стиль», пора вынести эти правила в skill. Тогда они будут лежать рядом с проектом или в личной библиотеке, а не теряться в истории переписки.

Skill не заменяет запрос

Запрос говорит агенту, что сделать сейчас, а skill объясняет, как обычно выполнять задачи такого типа. Туда удобно положить порядок проверки, команды проекта и понятный критерий готовности. Но описывать в одном файле все мыслимые ситуации не стоит: важные правила утонут в тексте.

---
name: review
description: Проверять изменения TypeScript перед ревью.
---

1. Сначала найди ошибки, меняющие поведение или безопасность.
2. Запусти относящиеся к изменению тесты.
3. В ответе укажи файл, строку и возможное последствие.

Название папки и формат frontmatter лучше сверить с документацией установленной версии OpenCode: проект быстро развивается, и старые примеры могут уже не подходить.

Что положить в навык

Хороший skill отвечает на четыре вопроса: когда он нужен, куда посмотреть, чего нельзя ломать и как понять, что работа закончена. Чем конкретнее формулировки, тем лучше. «После изменения API обнови типы и запусти npm test» полезнее, чем «сделай качественно».

API-ключи и пароли сюда класть нельзя. Инструкция попадает в контекст агента, а значит, может оказаться в истории, логах или общем репозитории.

Проверка на одной задаче

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

Для локального десктоп-агента посмотри свои навыки для Доки: там есть формат файла и повседневные примеры. Для действий во внешних системах начни с MCP-сервера в OpenCode.