---
title: "Навыки"
id: "347"
type: "page"
slug: "skills"
published_at: "2026-05-19T11:30:45+00:00"
modified_at: "2026-10-03T18:17:15+00:00"
url: "https://pastukhov.com/agents/agent/docs/skills"
markdown_url: "https://pastukhov.com/agents/agent/docs/skills.md"
excerpt: "Навыки — это «инструкции и инструменты», которые учат ИИ работе с вашим проектом. ИИ-модель сама…"
---

# Навыки

[https://pastukhov.com/agents/agent/docs/skills.md](https://pastukhov.com/agents/agent/docs/skills.md)

**Навыки — это «инструкции и инструменты», которые учат ИИ работе с вашим проектом.** ИИ-модель сама по себе знает о вас и вашем деле только то, что вы ей расскажете. Навыки аккуратно собирают это знание в одном месте: описание задачи, документы, примеры и готовые скрипты. Вместо того чтобы тратить время на объяснения при каждом новом разговоре, вы один раз создаёте навык — и дальше ИИ уже знает, что и как делать.

## Почему это важно: контекст

У ИИ-моделей есть ограниченная «рабочая память» — окно контекста: фиксированный объём текста, который модель может учесть за один раз. Всё, что вы хотите, чтобы ИИ знал о вашей задаче, должно поместиться в этот лимит. Поэтому управление контекстом — главный фактор хороших результатов.

Подстерегают две противоположные проблемы:

- **Слишком мало контекста** — если у ИИ недостаточно информации о вашем проекте и целях, он начнёт додумывать и выдаст неверный результат;
- **Слишком много контекста** — если загрузить в память всё подряд, внимание модели «размазывается» по куче тем, и на главном она начинает ошибаться.

Цель — давать модели ровно ту информацию, которая нужна для текущей задачи, не больше и не меньше. Именно для этого и созданы навыки.

## CLAUDE.md — «память по умолчанию»

По умолчанию в начале каждого чата всегда загружается файл `CLAUDE.md` — обычный текстовый файл с правилами проекта. Обычно в нём пишут самое общее: что это за проект, как он устроен, какие правила ИИ должен соблюдать всегда.

Для универсальных правил такой подход хорош. Но по мере роста проекта и появления разных задач — правка сайта, работа с базой данных, публикация изменений, аналитика — складывать всё в один файл становится плохо: возникает ровно та самая проблема «слишком много контекста». Модель тратит внимание на правила деплоя, когда вы просите её поправить страницу.

## Что такое навык?

Навык — это динамическая замена одному «монолитному» файлу. Вместо одного большого документа вы создаёте коллекцию специализированных навыков — каждый про свой тип задач. Начали новый чат — загрузили только тот навык, который нужен для текущей работы.

Навык — это **не один файл, а целая папка**:

- `SKILL.md` — главный файл с инструкциями; именно он загружается в память ИИ при активации навыка;
- **Документация** — справочные материалы, примеры, шаблоны;
- **Скрипты** — готовые программы (например, на Python) для автоматизации типовых действий;
- **Примеры** — образцы того, как должен выглядеть хороший результат.

Всё, что связано с одним типом задач, живёт в одном месте: документация говорит ИИ, что делать, скрипты дают ему инструменты для этого, а примеры показывают, к чему стремиться.

## Где они хранятся

Навыки лежат в папке проекта `.claude/skills/{имя-навыка}/` и хранятся **вместе с проектом** в общем хранилище истории изменений (Git). История правок навыков и кода проекта общая — все операции синхронизации и переключения версий применяются к ним одновременно.

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

Лучший способ — не редактировать навыки вручную, а **просить ИИ сделать это самому**. Заметили ошибку — скажите: «исправь это, а затем добавь правило в навык, чтобы этого больше не случалось». ИИ применит исправление и обновит навык прямо в этом же сеансе.

Улучшение идёт быстро, особенно в начале:

- **Из коробки** — ИИ работает без знаний о вашем проекте. Результаты общие, часто неточные;
- **После 20–30 улучшений** — обычно достигается около 85% точности для большинства задач. Здесь собраны самые лёгкие и заметные выигрыши;
- **После 100+ улучшений** — качество приближается к почти безупречному даже для задач, которые трудно описать строгими правилами.

Главное правило, когда вы просите ИИ обновлять навыки: **держите правки маленькими, а файлы навыков короткими**. Каждое обновление должно менять только необходимое — несколько строк, а не переписывание целиком. Модели склонны добавлять к каждому правилу много лишних объяснений, отчего навык «раздувается» и хуже укладывается в контекст. Поэтому явно просите сохранять изменения минимальными.

## Навык — свойство чата

Навык привязан к чату так же, как модель: выбранное значение хранится у каждого чата, восстанавливается при его открытии и передаётся дальше, когда создаётся новый чат. Отдельный выбор «без навыка» — полноценное значение, а не отсутствие настройки: в интерфейсе это пункт **«Без навыка»**, который стоит первым в списке навыков.

- **Выбор в чате** — селектор в области ввода показывает список навыков с их цветами, пункт «Без навыка» и кнопку перехода к управлению навыками. Открыли чат — селектор восстанавливает его навык, включая «Без навыка»;
- **Сохранение** — выбранное значение привязывается к текущему чату и одновременно становится значением по умолчанию для новых чатов;
- **Наследование** — новый чат из текущего (кнопка с переходом в новый чат, дубликат в Telegram) наследует его навык, включая «Без навыка»; новый чат из списка чатов берёт навык последнего активного чата;
- **Заранее известный навык** — задачи, боты, Telegram и API создания чатов принимают навык отдельным полем (например, запрос `chats/create` с параметром `skill`);
- **Кнопки** — кнопка может указывать навык явно через атрибут `skill="…"`: созданный из неё чат откроется с этим навыком; без атрибута новый чат наследует навык чата, из которого нажата кнопка;
- **Список чатов** — рядом с моделью показывается навык чата («модель • навык» с цветом навыка); у чатов без навыка — только модель.

Смена навыка в текущем чате сохраняется сервером и применяется к последующим сообщениям; для встроенной обвязки MiniAgent — со следующей сессии, потому что его системный промпт фиксируется при создании сессии (подробнее на странице [MiniAgent — встроенный агент](/agents/agent/docs/mini-agent)
). Старые чаты, созданные до этой возможности, получили навык автоматически: по первому факту загрузки навыка в истории чата, а без такого факта — значение «Без навыка».

## Автоматическая загрузка навыка

Раньше, чтобы навык загрузился, в начало первого сообщения чата вставлялась команда «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 — со следующей сессии).

## Управление навыками

Диалог навыков позволяет просматривать, редактировать, создавать и организовывать навыки. Он разделён на две панели: слева — список всех навыков, справа — редактор выбранного.

Список всех навыков фильтруется по имени (поиск с клавиатуры), а диалог запоминает последний выбранный навык и открытый файл. Для каждого навыка помнится свой файл: навык открывается на том файле, где вы его оставили, а не всегда на `SKILL.md`. Рядом с именем в списке есть пенал-кнопка, которая открывает диалог сразу с этим навыком из селектора чата.

У каждого навыка есть свой цвет для быстрого визуального распознавания в селекторе и списках чатов. Цвета хранятся в файле `.xedant/skills.yml` — по записи на навык (поле `color`); этот файл участвует в валидации проекта и синхронизируется между устройствами: изменили на одном — на остальных изменения появятся мгновенно.

Сами файлы навыков лежат в `.claude/skills/{имя-навыка}/` внутри проекта и сохраняются в Git вместе с ним.

Все навыки с файлом `SKILL.md` всегда активны и видны в селекторе — отдельного «выключения» нет.

- **Переименование** — пункт «Переименовать навык» в меню действий: введите новое имя, и папка навыка, название в файле `SKILL.md` и ссылки на него в задачах и ботах обновятся автоматически;
- **Копировать и вставить** — навык целиком (имя, цвет и все файлы) копируется в буфер обмена и вставляется обратно. Вставка поверх существующего навыка объединяет файлы: упомянутые перезаписываются, недостающие добавляются, остальные не трогаются; если в буфере не оказалось `SKILL.md` — он восстанавливается автоматически;
- **Экспорт и импорт** — один навык или все сразу выгружаются JSON-файлом (имя, описание, файлы, метка времени). При импорте имени, которое уже занято, новый навык создаётся под именем с меткой времени, а исходный остаётся нетронутым;
- **Live-обновление** — любые изменения навыков (правки в редакторе, изменения из Git, действия агента) мгновенно доходят до всех открытых окон и вкладок: списки навыков и селектор в чате обновляются сами, а открытый редактор не сбрасывается.

## Редактор навыков

Редактор в правой панели показывает все файлы навыка как вкладки. Первая вкладка — всегда `SKILL.md`, главный файл инструкций, который загружается в память ИИ. Остальные вкладки — другие файлы папки навыка.

Возможности редактора:

- **Вкладки** — быстрый переход между всеми файлами навыка;
- **Подсветка синтаксиса** — удобное цветное оформление кода в скриптах и файлах настроек;
- **Автосохранение** — изменения сохраняются сами, по мере работы;
- **Интеграция с Git** — можно сохранять изменения навыков в историю проекта прямо из редактора.

Правки навыков отслеживаются тем же хранилищем Git, что и проект: в панели Git изменения навыков видны вместе с изменениями кода — единая история.

Редактор умеет **запускать скрипты** прямо из папок навыков. Это удобно для рутинных операций — публикация изменений, работа с базой данных, сборка. Это и безопасно: чувствительные данные (пароли, ключи доступа, строки подключения к базам) хранятся на уровне модели проекта, а не внутри навыка.

И всё же постарайтесь **не редактировать файлы навыков и скрипты вручную**. Приучите себя (и сами модели) создавать и обновлять навыки через ИИ — например, используя навык управления навыками `demo.skills`. Модель лучше понимает структуру и правила оформления, а ручные правки незаметно «разъезжаются» в разные стороны.

## Аналитика по навыкам

Поскольку навык хранится у каждого чата, статистика по навыкам точная: раздел **«Навыки»** на странице [Аналитика](/agents/agent/docs/analytics)
 показывает три графика за выбранный период — токены по навыкам, стоимость по навыкам и общее время чатов по навыку. Чаты без навыка объединены в отдельную серию «Без навыка».

**← Назад:** [Настройки](/agents/agent/docs/settings)

**Далее:** [Модели](/agents/agent/docs/models)
 →