Навыки

Навык — это папка с файлом SKILL.md, где записана инструкция, как делать конкретную работу. Если нужно, рядом лежат справочники и скрипты. В каждый запрос агента попадают только имя и описание навыка. Полный текст агент загружает сам, когда задача подходит под описание. Навык можно вызвать и вручную, как команду.

#Как поставить навык

Основной способ — через агента: он скачает навык, проверит его и покажет, что именно ставит.

1. Пришлите агенту в чат что-то одно:
   • zip-архив с навыком (до 10 МБ);
   • ссылку на GitHub — на репозиторий, папку навыка или её файл SKILL.md;
   • прямую ссылку на zip-архив или на SKILL.md;
   • папку навыка: «+» слева в строке ввода → «Папка»;
   • текст или документ с просьбой «сделай из этого навык».
2. Агент покажет карточку «Изменить библиотеку навыков?». Библиотека — это ваши навыки на этом компьютере, в папке ~/.koder/skills. На карточке видно, откуда навык, сколько в нём файлов и какого они размера, какие скрипты и команды он запускает. Карточка отдельно предупредит, если навык обращается к сети или к секретам, содержит рекламу или указания против вас. Если вы заменяете навык, карточка покажет, какие файлы изменятся и что в них поменяется.
3. Нажмите на карточке «Разрешить» (Enter). Если нажмёте «Запретить» (Esc), навык не поставится.

После «Разрешить» навык работает сразу, в этом же чате: перезапускать ничего не нужно.

#Навык из другого агента

Если вы пользовались навыками в другом инструменте, попросите агента перенести их: укажите путь к папке навыка на компьютере или прикрепите её через «+» → «Папка». Агент поставит навык так же, с карточкой.

#Вручную

Положите папку навыка в ~/.koder/skills/<имя>/ так, чтобы файл лежал по пути ~/.koder/skills/<имя>/SKILL.md. На Windows это папка %USERPROFILE%\.koder\skills\<имя>\. Агент увидит навык после перезапуска DevMachine. При ручной установке карточки нет — проверьте содержимое сами.

#Как вызвать навык

• Агент сам. Он видит описания всех навыков и загружает нужный, когда задача подходит.
• Через «/». Наберите / в начале поля ввода и найдите в списке группу «Навыки». Можно и сразу набрать /<имя> <задача>, например /release-notes версия 2.4.
• Через «+». Нажмите «+» слева в строке ввода → «Навыки». Откроется список «Навыки агента» с поиском «Найти навык». Выберите навык — он встанет в поле ввода как /<имя> , и останется дописать задачу.
• Командой /skills. Она открывает тот же список.

#Как написать свой навык

Проще всего попросить агента: опишите, что должен уметь навык, или пришлите документ — агент соберёт навык и предложит его поставить. Если хотите написать навык сами, вот формат.

#Папка навыка

release-notes/
  SKILL.md
  references/      справочники, которые агент прочитает по ссылке из SKILL.md
  scripts/         скрипты, которые агент сможет запустить

Обязателен только SKILL.md.

#SKILL.md

В начале файла — блок с полями name и description, ниже — сама инструкция:

---
name: release-notes
description: Пишет заметки к выпуску по списку коммитов. Используй, когда просят описать изменения версии.
---

1. Найди последний тег: `git describe --tags --abbrev=0`.
2. Возьми коммиты после него: `git log <тег>..HEAD --oneline`.
3. Сгруппируй их: «Новое», «Исправления», «Прочее».
4. Пиши для пользователей, без внутренних названий задач.

• name — имя навыка: строчные латинские буквы, цифры и дефис, до 64 знаков, начинается с буквы или цифры. Имя shared и имена встроенных навыков заняты. Если имя не подходит, агент при установке предложит исправленное.
• description — главное поле. По нему агент решает, когда брать навык, поэтому пишите, что навык делает и когда его использовать.

Если навык пришёл из Claude Code, его поля model и context: fork действуют и здесь. С context: fork навык выполняет отдельный субагент — истории этого чата у него нет. Поле model задаёт модель этого субагента, но если она дороже модели чата, субагент работает на модели чата. Поля allowed-tools и hooks не действуют: навык не может сам выдать себе права. Если такие поля в навыке есть, карточка установки их назовёт. При установке переменная ${CLAUDE_SKILL_DIR} в файлах навыка заменяется путём к его папке.

#Пределы

• До 2 МБ в распакованном виде и до 256 файлов.
• Скачивание по ссылке — до 10 МБ, не дольше 60 секунд.
• Агент читает файлы установленных навыков и запускает их скрипты. Если включены ограничения агента, скрипты работают в песочнице: операционная система не даёт им писать вне разрешённых папок и выходить в сеть мимо списка адресов. Подробнее — Ограничения агента.

#Встроенные навыки

С приложением идут встроенные навыки: ставить их не нужно, удалить нельзя. Они включаются вместе с модулем в «Настройки → Модули».

#Как удалить навык

Попросите агента удалить навык — он покажет такую же карточку, как при установке. Или удалите папку навыка из ~/.koder/skills и перезапустите DevMachine. Встроенные навыки удалить нельзя: если они не нужны, выключите модуль.

#Ограничения

• Навыки хранятся только на этом компьютере и на сервер DevMachine не отправляются.
• Отдельного экрана для управления навыками нет: список — в «+» → «Навыки», установка и удаление — через агента.
• Навыки, сохранённые в репозитории, агент не загружает — только ваши из ~/.koder/skills и встроенные. Подробнее — Правила проекта.
• Проект на сервере. Агент работает на сервере и навыки берёт оттуда же, из ~/.koder/skills. Папку с этого компьютера прикрепить нельзя — пришлите навык zip-архивом.
• Что уходит наружу. Имена и описания навыков идут в каждом запросе к модели, полный текст — когда агент загрузил навык. При установке по ссылке навык скачивается с этого адреса, а сам адрес проверяют сетевые правила агента.

#Что дальше

• Свои команды и агенты — команды «/» и субагенты.
• Модули — включить Flow, 1С и другие встроенные умения.
• Команды «/» — все встроенные команды.
• Правила проекта — что агент знает о проекте с первого сообщения.