Skills

Skills — это директории с файлом SKILL.md, которые обучают агента выполнению специализированных задач. Kodik автоматически обнаруживает skills при запуске и предоставляет их агенту. Агент самостоятельно решает, когда skill релевантен, и применяет его. Пользователи могут явно вызывать skills через slash-команды.

Формат файла SKILL.md

Каждый skill — это папка, содержащая файл SKILL.md. Метаданные skill задаются в YAML-фронтматтере:

---
name: my-skill
description: Что делает этот skill и когда его использовать.
user-invocable: true
disable-model-invocation: false
---

## Обзор

Опишите назначение skill. Пишите как инструкции для агента.

## Рекомендации

- Предпочитай X
- Всегда делай Y
- Избегай Z

Поля фронтматтера

Поле	Обязательно	Описание
`name`	Да	Уникальный идентификатор skill (строчные буквы, дефисы вместо пробелов, максимум 64 символа). Используется для поиска skill и в имени slash-команды.
`description`	Да	Описание того, что делает skill и когда его использовать. Агент использует описание для решения о релевантности (максимум 1024 символа).
`user-invocable`	Нет	Отображается ли skill как slash-команда в меню `/`. По умолчанию `true`. При `false` skill скрыт из меню, но агент всё равно может загрузить его автоматически.
`disable-model-invocation`	Нет	Запрещает агенту загружать skill автоматически. По умолчанию `false`. При `true` skill доступен только через явную slash-команду.

Расположение skills

Kodik обнаруживает skills из следующих мест (перечислены в порядке убывания приоритета; при совпадении имён побеждает источник с более высоким приоритетом):

Расположение	Область	Приоритет
`.kodik/skills/` в репозитории	Проект	4
`.agents/skills/` в репозитории	Проект (универсальный)	2
`~/Documents/Kodik/Skills/`	Пользователь (глобально)	1
`~/.agents/skills/`	Пользователь (universal)	0
Skills из плагинов	Плагин	0

Skills из плагинов имеют имена с префиксом в виде идентификатора плагина (<plugin-id>:<name>).

Как агент применяет skills

При каждом запросе агенту предоставляется список доступных skills (имя + описание). Агент самостоятельно решает, какие skills релевантны, и загружает их содержимое. Если у skill установлен флаг disable-model-invocation: true, агент его не загружает автоматически — skill доступен только по явному вызову пользователя.

Вызов skill пользователем

Если skill имеет user-invocable: true (значение по умолчанию), его можно вызвать, введя /имя-skill в поле ввода чата. Все доступные user-invocable skills отображаются в меню /. Подробнее — в обзоре slash-команд.

Создание skill

Чтобы создать skill через агента, введите /create-skill (или /createskill) в поле ввода чата. Команда запросит имя и описание, затем создаст папку с файлом SKILL.md в нужном расположении.

Структура skill минимальна — достаточно одной папки с SKILL.md:

.kodik/skills/
└── deploy-app/
    └── SKILL.md

Опционально можно добавить дополнительные файлы:

.kodik/skills/
└── deploy-app/
    ├── SKILL.md
    ├── scripts/
    │   └── deploy.sh
    └── references/
        └── REFERENCE.md

Пример skill

---
name: webapp-testing
description: Руководство по тестированию веб-приложений с Playwright. Использовать при написании или запуске браузерных тестов.
---

# Тестирование веб-приложений с Playwright

## Создание тестов

1. Определите пользовательский сценарий
2. Создайте файл теста в директории `tests/`
3. Используйте локаторы Playwright (предпочитайте role-based)
4. Добавьте assertions

## Запуск тестов

\`\`\`bash
npx playwright test
npx playwright test --debug
\`\`\`