Навыки — это «инструкции и инструменты», которые учат ИИ работе с вашим проектом. ИИ-модель сама по себе знает о вас и вашем деле только то, что вы ей расскажете. Навыки аккуратно собирают это знание в одном месте: описание задачи, документы, примеры и готовые скрипты. Вместо того чтобы тратить время на объяснения при каждом новом разговоре, вы один раз создаёте навык — и дальше ИИ уже знает, что и как делать.
Почему это важно: контекст
У ИИ-моделей есть ограниченная «рабочая память» — окно контекста: фиксированный объём текста, который модель может учесть за один раз. Всё, что вы хотите, чтобы ИИ знал о вашей задаче, должно поместиться в этот лимит. Поэтому управление контекстом — главный фактор хороших результатов.
Подстерегают две противоположные проблемы:
- Слишком мало контекста — если у ИИ недостаточно информации о вашем проекте и целях, он начнёт додумывать и выдаст неверный результат;
- Слишком много контекста — если загрузить в память всё подряд, внимание модели «размазывается» по куче тем, и на главном она начинает ошибаться.
Цель — давать модели ровно ту информацию, которая нужна для текущей задачи, не больше и не меньше. Именно для этого и созданы навыки.
CLAUDE.md — «память по умолчанию»
По умолчанию в начале каждого чата всегда загружается файл CLAUDE.md — обычный текстовый файл с правилами проекта. Обычно в нём пишут самое общее: что это за проект, как он устроен, какие правила ИИ должен соблюдать всегда.
Для универсальных правил такой подход хорош. Но по мере роста проекта и появления разных задач — правка сайта, работа с базой данных, публикация изменений, аналитика — складывать всё в один файл становится плохо: возникает ровно та самая проблема «слишком много контекста». Модель тратит внимание на правила деплоя, когда вы просите её поправить страницу.
Что такое навык?
Навык — это динамическая замена одному «монолитному» файлу. Вместо одного большого документа вы создаёте коллекцию специализированных навыков — каждый про свой тип задач. Начали новый чат — загрузили только тот навык, который нужен для текущей работы.
Навык — это не один файл, а целая папка:
SKILL.md— главный файл с инструкциями; именно он загружается в память ИИ при активации навыка;- Документация — справочные материалы, примеры, шаблоны;
- Скрипты — готовые программы (например, на Python) для автоматизации типовых действий;
- Примеры — образцы того, как должен выглядеть хороший результат.
Всё, что связано с одним типом задач, живёт в одном месте: документация говорит ИИ, что делать, скрипты дают ему инструменты для этого, а примеры показывают, к чему стремиться.
Где они хранятся
Навыки лежат в папке проекта .claude/skills/{имя-навыка}/ и хранятся вместе с проектом в общем хранилище истории изменений (Git). История правок навыков и кода проекта общая — все операции синхронизации и переключения версий применяются к ним одновременно.
Как улучшать навыки
Лучший способ — не редактировать навыки вручную, а просить ИИ сделать это самому. Заметили ошибку — скажите: «исправь это, а затем добавь правило в навык, чтобы этого больше не случалось». ИИ применит исправление и обновит навык прямо в этом же сеансе.
Улучшение идёт быстро, особенно в начале:
- Из коробки — ИИ работает без знаний о вашем проекте. Результаты общие, часто неточные;
- После 20–30 улучшений — обычно достигается около 85% точности для большинства задач. Здесь собраны самые лёгкие и заметные выигрыши;
- После 100+ улучшений — качество приближается к почти безупречному даже для задач, которые трудно описать строгими правилами.
Главное правило, когда вы просите ИИ обновлять навыки: держите правки маленькими, а файлы навыков короткими. Каждое обновление должно менять только необходимое — несколько строк, а не переписывание целиком. Модели склонны добавлять к каждому правилу много лишних объяснений, отчего навык «раздувается» и хуже укладывается в контекст. Поэтому явно просите сохранять изменения минимальными.
Навык — свойство чата
Навык привязан к чату так же, как модель: выбранное значение хранится у каждого чата, восстанавливается при его открытии и передаётся дальше, когда создаётся новый чат. Отдельный выбор «без навыка» — полноценное значение, а не отсутствие настройки: в интерфейсе это пункт «Без навыка», который стоит первым в списке навыков.
- Выбор в чате — селектор в области ввода показывает список навыков с их цветами, пункт «Без навыка» и кнопку перехода к управлению навыками. Открыли чат — селектор восстанавливает его навык, включая «Без навыка»;
- Сохранение — выбранное значение привязывается к текущему чату и одновременно становится значением по умолчанию для новых чатов;
- Наследование — новый чат из текущего (кнопка с переходом в новый чат, дубликат в Telegram) наследует его навык, включая «Без навыка»; новый чат из списка чатов берёт навык последнего активного чата;
- Заранее известный навык — задачи, боты, Telegram и API создания чатов принимают навык отдельным полем (например, запрос
chats/createс параметромskill); - Кнопки — кнопка может указывать навык явно через атрибут
skill="…": созданный из неё чат откроется с этим навыком; без атрибута новый чат наследует навык чата, из которого нажата кнопка; - Список чатов — рядом с моделью показывается навык чата («модель • навык» с цветом навыка); у чатов без навыка — только модель.
Смена навыка в текущем чате сохраняется сервером и применяется к последующим сообщениям; для встроенной обвязки MiniAgent — со следующей сессии, потому что его системный промпт фиксируется при создании сессии (подробнее на странице MiniAgent — встроенный агент). Старые чаты, созданные до этой возможности, получили навык автоматически: по первому факту загрузки навыка в истории чата, а без такого факта — значение «Без навыка».
Автоматическая загрузка навыка
Раньше, чтобы навык загрузился, в начало первого сообщения чата вставлялась команда «start with loading skill {название}»: она попадала в сохраняемое сообщение, влияла на заголовок чата и мешала при копировании и редактировании. Теперь загрузка полностью автоматическая: требование доставляется каждой обвязке её собственным внеполосным каналом — строкой системного промпта, флагом запуска, переменной окружения или файлом, привязанным к чату. Пользовательское сообщение остаётся чистым.
Как требование доставляется по всем десяти обвязкам (проверено на живой системе):
| Обвязка | Канал доставки требования | Обнаружение навыков |
| Claude Code | флаг запуска --append-system-prompt (каждый ход) | нативное чтение .claude/skills |
| MiniAgent | строка в системном промпте (MiniAgentOptions.Skill) | нативное — инструмент load_skill |
| Codex | флаг -c developer_instructions=… (каждый ход) | нативное; указатель на папку навыков внутри строки |
| OpenCode | переменная OPENCODE_CONFIG_CONTENT → файл инструкций чата | нативное сканирование .claude/skills |
| Pi | флаг --append-system-prompt (процесс чата) | нет ⇒ указатель на папку навыков внутри строки |
| Oh My Pi | тот же флаг --append-system-prompt | нет ⇒ указатель на папку навыков внутри строки |
| DeepSeek Harness | переменная DSH_SYSTEM_PROMPT (персона + строка, при каждом запуске) | нет ⇒ указатель на папку навыков внутри строки |
| Kimi Code | флаг --agent-file (обёртка ${base_prompt}; применяется при создании сессии) | только свои каталоги ⇒ указатель на папку навыков внутри строки |
| Reasonix | файл REASONIX.md + строка [skills] paths в config.toml (у каждого чата свой каталог) | нативное через [skills] paths |
| Command Code | флаг --mod (хук appendSystemPrompt, каждый ход) | флаг --skill — дополнительный корень навыков для чата |
Файлы, создаваемые для каналов (OpenCode, Kimi Code, Reasonix, Command Code), лежат в домашнем каталоге агента в папке chats/chat-{id}/ — по файлу на каждый чат. Никаких общих файлов на машине или внутри проекта: разные чаты с разными навыками не мешают друг другу, а у чата без навыка ничего не создаётся вовсе.
Что получает агент при загрузке
В контекст попадает не строка-команда, а полное содержимое навыка: SKILL.md со всеми инструкциями и все файлы папки навыка — документация, скрипты, примеры. Весь каталог .claude/skills при этом доступен агенту целиком: при необходимости он может открыть и другие навыки. MiniAgent дополнительно перечисляет доступные навыки в системном промпте, а его инструмент load_skill загружает выбранный навык на месте.
Что изменилось для пользователя
- Промпты чистые — в сообщениях, заголовках чатов, копировании и редактировании больше нет служебной команды загрузки навыка;
- Заголовки корректные — название чата считается от вашего первого сообщения;
- Переключение навыка по ходу разговора — новый навык применяется со следующих сообщений (для MiniAgent, Kimi Code и Reasonix — со следующей сессии).
Управление навыками
Диалог навыков позволяет просматривать, редактировать, создавать и организовывать навыки. Он разделён на две панели: слева — список всех навыков, справа — редактор выбранного.
Список всех навыков фильтруется по имени (поиск с клавиатуры), а диалог запоминает последний выбранный навык и открытый файл между открытиями; рядом с именем в списке есть пенал-кнопка, которая открывает диалог сразу с этим навыком из селектора чата.
У каждого навыка есть свой цвет для быстрого визуального распознавания в селекторе и списках чатов. Цвета хранятся в файле .xedant/skills.yml — по записи на навык (поле color); этот файл участвует в валидации проекта и синхронизируется между устройствами: изменили на одном — на остальных изменения появятся мгновенно.
Сами файлы навыков лежат в .claude/skills/{имя-навыка}/ внутри проекта и сохраняются в Git вместе с ним.
Все навыки с файлом SKILL.md всегда активны и видны в селекторе — отдельного «выключения» нет.
- Копировать и вставить — навык целиком (имя, цвет и все файлы) копируется в буфер обмена и вставляется обратно. Вставка поверх существующего навыка объединяет файлы: упомянутые перезаписываются, недостающие добавляются, остальные не трогаются; если в буфере не оказалось
SKILL.md— он восстанавливается автоматически; - Экспорт и импорт — один навык или все сразу выгружаются JSON-файлом (имя, описание, файлы, метка времени). При импорте имени, которое уже занято, новый навык создаётся под именем с меткой времени, а исходный остаётся нетронутым;
- Live-обновление — любые изменения навыков (правки в редакторе, изменения из Git, действия агента) мгновенно доходят до всех открытых окон и вкладок: списки навыков и селектор в чате обновляются сами, а открытый редактор не сбрасывается.
Редактор навыков
Редактор в правой панели показывает все файлы навыка как вкладки. Первая вкладка — всегда SKILL.md, главный файл инструкций, который загружается в память ИИ. Остальные вкладки — другие файлы папки навыка.
Возможности редактора:
- Вкладки — быстрый переход между всеми файлами навыка;
- Подсветка синтаксиса — удобное цветное оформление кода в скриптах и файлах настроек;
- Автосохранение — изменения сохраняются сами, по мере работы;
- Интеграция с Git — можно сохранять изменения навыков в историю проекта прямо из редактора.
Правки навыков отслеживаются тем же хранилищем Git, что и проект: в панели Git изменения навыков видны вместе с изменениями кода — единая история.
Редактор умеет запускать скрипты прямо из папок навыков. Это удобно для рутинных операций — публикация изменений, работа с базой данных, сборка. Это и безопасно: чувствительные данные (пароли, ключи доступа, строки подключения к базам) хранятся на уровне модели проекта, а не внутри навыка.
И всё же постарайтесь не редактировать файлы навыков и скрипты вручную. Приучите себя (и сами модели) создавать и обновлять навыки через ИИ — например, используя навык управления навыками demo.skills. Модель лучше понимает структуру и правила оформления, а ручные правки незаметно «разъезжаются» в разные стороны.
Аналитика по навыкам
Поскольку навык хранится у каждого чата, статистика по навыкам точная: раздел «Навыки» на странице Аналитика показывает три графика за выбранный период — токены по навыкам, стоимость по навыкам и общее время чатов по навыку. Чаты без навыка объединены в отдельную серию «Без навыка».