Справочник

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

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

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

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

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

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

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

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

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

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

Размер — это длина текста инструкций в байтах, делённая на четыре и округлённая вверх. Реальное число токенов зависит от модели. Это размер того, что ассистент загружает, когда открывает навык, а не лимит контекста и не измеренный расход в чате. Загрузка означает, что 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 — устоявшиеся приёмы написания заметок, собранные из руководств по стилю, стандартов и исследований того, как читают люди и ассистенты. В нём: писать для читателя, которого не было в разговоре; ставить абсолютные даты и точные идентификаторы; не выдумывать причины и источники и не оставлять следов переписки; использовать привычные части девяти видов заметок (решение, инструкция, чек-лист, проблема и исправление, встреча или разговор, статус проекта, источник, понятие, человек или организация), пропуская части, для которых в разговоре ничего не нашлось.

Выбранные варианты задают его охват, начало, формат и обоснование; подробнее — Что делает каждая настройка. Указания о заметках из твоего навыка или профиля дополняют его; где они расходятся, действует memex-writing. Если выбрать Писать по своим правилам, он выключается. Это указание ассистенту, memex его никогда не проверяет, а твоя просьба в разговоре всегда важнее.

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

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

Профиль

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

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

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

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

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

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

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