feat: migrate .opencode/ config from opencode (#23 )

* feat: migrate .opencode/ config from opencode

* refactor: rename repo refs and sanitize for public

* docs(handoff): add pr-7 handoff + ADR-002

* docs(handoff): fix PR number

* docs: update project map with .opencode/ structure

---------

Co-authored-by: opencode-agent <agent@slaid098.dev>

2026-07-23 22:57:39 +03:00

3.1 KiB

Raw Blame History

name	description
add-skill	Use when creating a new opencode skill. Covers file location, frontmatter format, commit, push, and post-instructions for restart. Also when user says "добавь скилл", "создай скилл", "новый навык".

Add Skill

Процесс создания нового скилла в opencode.

1. Куда создавать

config/skills/<skill-name>/SKILL.md

В корне текущего репо (<repo-root> = git rev-parse --show-toplevel), в config/skills/. НЕ в ~/.config/opencode/ — эта папка синхронизируется из репо.

2. Формат SKILL.md

---
name: <skill-name>
description: <когда загружать. Триггеры на русском и английском. Например: Use when ... Also when user says "...">
---

# Skill Title

Содержание скилла.

Правила

name — kebab-case, совпадает с именем директории
description — содержит конкретные триггеры (когда агент должен загрузить этот скилл)
Язык тела — русский с английскими техническими терминами (как в существующих скиллах)
Один скилл — одна директория с одним SKILL.md

Примеры существующих скиллов

config/skills/
├── add-skill/SKILL.md          ← этот скилл
├── branch/SKILL.md
├── code-standards/SKILL.md
├── commit/SKILL.md
├── get-project-map/SKILL.md
├── issue/SKILL.md
├── memory/SKILL.md
├── pipeline-driver/SKILL.md
├── python-development/SKILL.md
├── repo-init/SKILL.md
├── run-tests/SKILL.md
└── spec-driver/SKILL.md

3. Скиллы авто-дискаверятся

Opencode сканирует все под-директории config/skills/ и подхватывает любой SKILL.md. Регистрировать ничего не нужно.

Список скиллов загружается при старте контейнера. Новый скилл станет доступен только после рестарта.

4. Commit и Push

После создания файла — сразу коммит и пуш по правилам скилла commit:

cd "$(git rev-parse --show-toplevel)"
git add config/skills/<skill-name>/SKILL.md
git commit -m "feat(skills): add <skill-name> skill for <purpose>"
git push

5. Инструкция пользователю

После push сообщить пользователю:

Скилл создан и запушен. Чтобы он заработал:

На хосте: git pull в репозитории opencode

Рестарт контейнера

После рестарта скилл появится в available_skills и будет загружаться по триггерам из description.

3.1 KiB Raw Blame History Unescape Escape