# Как работают навыки

> Как ассистенты получают навыки, страница «Навыки» и страница навыка, встроенные навыки, профиль и три тега, которые читает memex.

Страница: https://docs.memex.tools/ru/how-skills-work

Навык — это заметка о том, как ты хочешь, чтобы делалась какая-то работа. Memex сообщает о нём каждому подключённому ассистенту, но сам никогда его не применяет. Подключённые ассистенты получают список названий и описаний навыков; когда задача подходит под один из них, ассистент запрашивает эту заметку и следует ей. Навык срабатывает не потому, что он есть, а потому, что под него подошла задача.

## Как создать навык

Поставь заметке тег `skill` — как только она станет проверенной, ассистенты начнут её получать. Заметка, которую предложил ассистент, сначала ждёт во входящих, как любая другая. Или нажми **Новый навык** на странице «Навыки»: откроется редактор с уже поставленным тегом и короткой заготовкой (когда применять, шаги, источники), которую остаётся заполнить. Готовый навык из файла `SKILL.md`, папки на GitHub или со страницы skills.sh добавляй через ассистента: дай ему ссылку, и он предложит навык вместе с навыками, которые тот загружает, или объяснит, почему через memex навык работать не сможет. Файл `SKILL.md`, который уже есть у тебя, добавляется через **Новый навык** › **Импорт из файла…**.

Навыки показываются на странице **Навыки**, а не **Заметки**: в списке заметок, его поиске, фильтре по тегам и на карте навыков нет, а ссылка на навык открывает его на странице «Навыки».

## Страница «Навыки»

**Навыки** — это один список: **Мои навыки** или **Системные навыки**, смотря что выбрано в меню над ним. Вместе они не показываются. Рядом с меню — число включённых навыков и их общий размер в токенах (**ток.**). Сначала идут недавно использованные. В каждой строке — **Включён** или **Выключен** у названия, описание, дата последнего использования или **Не использовался** и размер.

В списке **Мои навыки** есть и навыки из комплекта memex, которых ещё нет в заметках, — со статусом **Выключен**. Их короткие имена начинаются с `skill-`. Если включить такой навык, он добавится в заметки как твой собственный, уже включённый: его можно менять, переименовывать и удалять, как любой другой.

В виде **Одна панель** твой навык открывается на своей странице, а системный навык или шаблон — поверх списка; «Назад» возвращает к списку. В виде [«Две панели»](https://docs.memex.tools/ru/frames) любой навык открывается справа, и его редактор тоже.

Размер — это длина текста инструкций в байтах, делённая на четыре и округлённая вверх. Реальное число токенов зависит от модели. Это размер того, что ассистент загружает, когда открывает навык, а не лимит контекста и не измеренный расход в чате. Загрузка означает, что memex отправил инструкции, но не доказывает, что ассистент им последовал.

Название и описание навыка берутся из заголовка заметки и сохранённого описания. Описания системных навыков и шаблонов берутся из файлов, встроенных в memex.

## Страница навыка

Навык открывается как заметка, к которой добавлены части навыка. Переключатель стоит перед названием. **Изменить навык** открывает редактор: там можно поменять текст, теги и короткое имя или удалить навык, как любую заметку. Рядом — **Пометить для куратора** и **Скачать SKILL.md**. История — там же, где у заметки; карты и обратных ссылок у навыка нет. Рядом с инструкциями, в одном блоке, — **Кто может пользоваться навыком**, **Короткое имя** с кнопкой копирования и **Как пользоваться навыком**. Ниже, если они есть, — **Рекомендации**. Ещё ниже **О навыке**: сколько раз навык загружали за последние 30 дней (**Загрузки**), когда его использовали в последний раз (**Последнее использование**), какие подключения им пользуются и как часто (**Кто использует**), а потом даты создания и изменения, размер и теги. Сними тег `skill` — и навык станет обычной заметкой на странице **Заметки**.

Переключатель перед названием — единственный. Если его включить, навык станет доступен всеми способами, которые поддерживает MCP (инструменты, ресурсы и промпты); если выключить — доступ закроется, а заметка не изменится. Выбирать между этими техническими способами не нужно. Включённый навык делает инструкции доступными, но не гарантирует, что ассистент решит ими воспользоваться.

Отмечены все подключения, и подключение, добавленное позже, тоже будет отмечено. Чтобы закрыть навык для какого-то подключения, сними с него отметку и нажми **Сохранить подключения**. **Сохранить подключения** — кнопка с рамкой. Пока выбор не сохранён, видна надпись **Есть несохранённые изменения**.

**Короткое имя** — точное имя, по которому ищут навык (его slug). Оно меняется в редакторе, под полем **Теги**, и сохраняется вместе со всем остальным; обычно его можно не трогать. Переименование заметки короткое имя не меняет, но если сменить короткое имя, старые промпты с ним придётся поправить. Имя закрепляется, когда навык впервые получает ассистент или когда его впервые открывают здесь. При совпадении к имени добавляется номер (всё имя — не длиннее 64 символов), даже если другой запрос в тот же момент занимает то же имя. У заметок на проверке — отдельные временные имена для скачивания. В имени можно использовать строчные латинские буквы, цифры и одиночные дефисы, без пробелов. Занятое имя не принимается, и какая заметка его заняла, не сообщается.

Навык на проверке можно посмотреть во входящих или одобрить на его странице, как любую заметку на проверке; переключатель, короткое имя и подключения заработают только после этого. Наведи курсор на подключение в **Кто использует**, чтобы увидеть, когда оно в последний раз загружало навык.

Рекомендации отмечают отсутствующие, слишком короткие или слишком длинные описания, инструкции длиннее примерно 5 000 токенов по оценке, совпадения имён и навыки, которые не загружали 30 дней. **Скачать SKILL.md** сохраняет переносимый файл.

## Системные навыки

`memex-recall` объясняет, как читать и писать в memex; в `memex-curation` — правила наведения порядка; `memex-profile` объясняет, как устроены заметки-профили; `memex-docs` — эта документация; `memex-skills` объясняет, как писать и проверять навыки; а `memex-writing` — как писать заметку здесь, с учётом вариантов, выбранных в **Настройки › Персонализация**. Они обновляются вместе с memex, пока ты их не разблокируешь, и включены для всех подключений, а `memex-writing` — пока ты его не выключишь. «Включён» значит, что навык можно загрузить, а не что его полный текст вставляется в каждый чат. В списке **Системные навыки** на странице «Навыки» — те четыре, которые можно разблокировать; `memex-docs` и `memex-writing` ассистенты получают так же, но там их нет.

Разблокировать можно `memex-curation`, `memex-recall`, `memex-profile` и `memex-skills`. Открой нужный в списке **Системные навыки** и нажми **Разблокировать**: memex скопирует его текст в твой собственный навык, и ассистенты будут получать уже копию под тем же коротким именем. Копия всегда включена и доступна всем подключениям. Короткое имя поменять нельзя: на него ссылаются инструменты самого memex. Разблокированный навык больше не получает обновлений memex; когда memex меняет свой текст, страница навыка об этом сообщает. **Вернуть версию memex** снова блокирует навык: ассистенты снова получают текст memex, и он снова обновляется, твоя копия получает этот текст как новую версию, а твои правки остаются в её истории. Если потом снова разблокировать навык, откроется та же копия. Твои инструкции для уборки по-прежнему добавляются к разблокированному `memex-curation`. Изменение, которое ассистент предлагает для разблокированного навыка, ждёт тебя, даже если его предлагает куратор. Если удалить копию или снять с неё тег `skill`, ассистенты снова будут получать версию memex; если восстановить копию из раздела **Удалённые заметки**, снова будет действовать она. `memex-docs` и `memex-writing` разблокировать нельзя: документация повторяет этот сайт, а `memex-writing` следует выбранным вариантам.

## memex-writing

`memex-writing` — устоявшиеся приёмы написания заметок, собранные из руководств по стилю, стандартов и исследований того, как читают люди и ассистенты. В нём: писать для читателя, которого не было в разговоре; ставить абсолютные даты и точные идентификаторы; не выдумывать причины и источники и не оставлять следов переписки; использовать привычные части девяти видов заметок (решение, инструкция, чек-лист, проблема и исправление, встреча или разговор, статус проекта, источник, понятие, человек или организация), пропуская части, для которых в разговоре ничего не нашлось.

Выбранные варианты задают его охват, начало, формат и обоснование; подробнее — [Что делает каждая настройка](https://docs.memex.tools/ru/every-setting). Указания о заметках из твоего навыка или профиля дополняют его; где они расходятся, действует `memex-writing`. Если выбрать **Писать по своим правилам**, он выключается. Это указание ассистенту, memex его никогда не проверяет, а твоя просьба в разговоре всегда важнее.

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

Попроси ассистента: «Сделай описание моего навыка для заметок о встречах короче и точнее» — или просто укажи на рекомендацию на странице навыка. Он загрузит `memex-skills`: там сказано, каким должно быть описание, чтобы ассистент узнавал по нему подходящую задачу, каким по размеру должен оставаться навык и что изменение надо предложить патчем, а не применить сразу. Так правка ждёт во входящих, как любая другая.

## Профиль

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

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

В разделе **Настройки › Персонализация** видно, есть ли у тебя профиль, и там его можно открыть или начать. А можно попросить ассистента начать профиль с того, что он уже о тебе знает. Пиши коротко: профиль читают часто. В его разделах курсивом указано, что ещё не написано, и ассистент считает такой раздел неизвестным. Собственные указания memex для профиля — это встроенный навык `memex-profile`, а не строки в твоей заметке, поэтому в ней нет ничего, что обязательно нужно сохранять.

Что туда писать — решать тебе. В разделе профиля *Boundaries* ты указываешь, можно ли хранить в заметках личные сведения, которыми ты делишься, и ассистенты применяют это ко всем заметкам, которые пишут здесь. Заметок-профилей может быть две: ассистентам сообщают об обеих, и ни одну они не ставят выше другой.

## Три тега, которые читает сам memex

Первый — `skill`. Второй — `live-state`: ставь его заметке, которая описывает то, что меняется (сервер, конфигурацию, текущее состояние проекта). Тогда каждого ассистента, который читает её по MCP, в том же ответе попросят исправить заметку, если его собственная работа только что сделала её неверной. Третий — `user-profile`, о нём выше.

Ни один из этих трёх тегов нельзя убрать из списка тегов: это незаметно отключило бы их действие у всех заметок, где они стоят. Отдельным заметкам их можно свободно ставить и снимать.

## По теме

- [Навыки](https://docs.memex.tools/ru/skills): Заметки с инструкциями, которые ассистент загружает под подходящую задачу, и как их создавать и настраивать.
- [Профиль](https://docs.memex.tools/ru/profile): Заметка о тебе, которую читает каждый подключённый ассистент, — чтобы не рассказывать о себе в каждом чате.
- [Правила написания заметок](https://docs.memex.tools/ru/writing-rules): Как ассистенты пишут заметки в memex и как настроить правила или задать свои.
- [Как ассистенты получают навыки и инструкции](https://docs.memex.tools/ru/skills-over-mcp): Что memex сообщает ассистенту при подключении, какими способами отдаёт навыки, как изменение доходит до подключения и какие указания приходят вместе с заметками live-state и профилем.
