Перейти к содержимому
Понедельник, Ноябрь 16, 2026НЕЗАВИСИМЫЕ ТЕХНИЧЕСКИЕ НОВОСТИ, ОБЗОРЫ И ПРАКТИЧЕСКИЕ РУКОВОДСТВА
О ПРОЕКТЕ
ПОСЛЕДНЕЕ /

Навыки агентов и серверы MCP: как установить, обновить и исправить их в OpenCode, Claude Code, Codex и других ИИ-агентах

ЧИТАТЬ РУКОВОДСТВО
ИИ-АГЕНТЫGM / 997

Навыки агентов и серверы MCP: как установить, обновить и исправить их в OpenCode, Claude Code, Codex и других ИИ-агентах

Agent Skills и MCP-серверы: как установить, обновить и исправить их в OpenCode, Claude Code, Codex и других с помощью CLI npx skills — пошагово.

Agent skills and MCP servers explained: a tech.grahammiranda.com title card with SKILL.md, npx skills, MCP servers and .agents/skills, and a terminal running npx skills check and opencode mcp add

ИИ-агент для кодинга сразу после установки — как блестящий новый сотрудник в первое утро. Он умеет рассуждать, писать код и выполнять команды, но не знает, как устроены дела в вашей команде, и у него нет ключей к вашим системам. Навыки агентов и серверы MCP закрывают ровно эти два пробела. Навык — это записанный свод правил, который агент снимает с полки, когда задача в нём нуждается. Сервер MCP — это набор ключей: небольшая программа, которая позволяет агенту пользоваться тем, до чего он раньше не мог добраться, например вашими задачами в GitHub, настоящим браузером или актуальной документацией.

Это руководство объясняет и то и другое простым языком, а затем показывает, как устанавливать, обновлять, удалять и отлаживать их в OpenCode, Claude Code, Codex, Gemini CLI, Cursor, GitHub Copilot и Hermes Agent. Большая часть работает одинаково везде, потому что теперь оба стандарта открытые. Со стороны навыков всё связывает один небольшой инструмент командной строки, npx skills, и я разберу его команду за командой.

Я не разработчик по образованию. Я управляю небольшой IT-компанией в Германии и создаю программы с помощью ИИ-агентов, поэтому большую часть этого я освоил так, как, вероятно, освоите и вы: ломая всё. Часть 6 собрана из моих собственных сессий в терминале на Mac и Raspberry Pi, включая тот раз, когда инструмент сообщил, что все мои навыки актуальны, хотя не смог проверить ни одного.

Всё ниже сверено с официальной документацией каждого агента и, для навыки CLI, с опубликованным исходным кодом версий с 1.5.18 по 1.8.1, на 15 ноября 2026 года. Эти инструменты меняются каждую неделю: только за эту неделю CLI выпустил два релиза, а OpenCode достиг 2.3.0 13 ноября. Номера версий и поведение отмечены там, где они, скорее всего, изменятся. Проверяйте их, прежде чем на них полагаться.

Раскрытие информации: Ни одна компания, упомянутая в этой статье, не спонсировала, не рецензировала и не одобряла её, и в ней нет партнёрских ссылок. Продукты названы только в тексте; на изображениях мои собственные логотипы.


TL;DR — навыки агентов и серверы MCP в десяти пунктах

  • Навык — это папка с SKILL.md файл: вверху название и описание, ниже инструкции, а также необязательные скрипты или справочные файлы. Агенты читают только описание, пока задача не потребует навыка, поэтому неиспользуемый навык стоит примерно 100 токенов внимания агента.
  • Сервер MCP даёт агенту новые инструменты, например GitHub, браузер или живую документацию. Описания инструментов могут передаваться с каждым запросом, поэтому подключайте только те серверы, которые используете. Claude Code теперь откладывает их до момента необходимости, а OpenCode группирует их по серверу.
  • Практическое правило: правила для каждой задачи — в AGENTS.md; знания, нужные для отдельных задач, становятся навыком; живой доступ к системе требует сервера MCP; а если хороший инструмент командной строки уже существует, навык, который учит агента этому инструменту, часто дешевле сервера.
  • Оба — открытые стандарты в рамках Agentic AI Foundation при Linux Foundation: MCP с декабря 2025 года, Agent Skills с 22 октября 2026 года. Навык, написанный для одного агента, обычно работает и в других.
  • .agents/skills — это общая папка. Codex, OpenCode, Cursor, Gemini CLI и GitHub Copilot читают .agents/skills в проекте и ~/.agents/skills в вашей домашней папке. Claude Code читает только .claude/skills, а Hermes Agent читает ~/.hermes/skills плюс любые папки, которые вы добавите.
  • npx skills — это npm для навыков. Открытый CLI от Vercel (версия 1.8.1) устанавливает навыки в 79 агентов: npx skills add owner/repo, -g для всех проектов, -a opencode -a claude-code чтобы выбрать агентов, npx skills ls для просмотра списка и npx skills remove для удаления.
  • Чтобы проверить, актуальны ли ваши навыки, запустите npx skills@latest check. Начиная с версии 1.7.5 (2 ноября 2026) он только сообщает результат; npx skills update устанавливает. В более ранних версиях check тихо выполнял обновление.
  • Никогда не полагайтесь только на зелёную галочку. Когда лимит GitHub в 60 анонимных запросов в час блокировал все проверки на моём Mac, CLI всё равно вывел “Все глобальные навыки актуальны”. Запустите gh auth login или задайте GITHUB_TOKEN, и читайте строки с ✗.
  • Никогда не используйте sudo с навыками или агентами и не запускайте CLI из своей домашней папки. У root есть отдельная домашняя папка, поэтому sudo создаёт второе, невидимое хранилище навыков; а из ~ CLI принимает вашу домашнюю папку за проект.
  • Относитесь к навыкам и MCP-серверам как к программному обеспечению, которое вы устанавливаете. Аудит 3 984 публичных навыков в феврале 2026 года выявил уязвимости в 36,82% из них и подтвердил наличие вредоносных полезных нагрузок в 76. Читайте перед установкой, отдавайте предпочтение навыкам от самих создателей инструмента, фиксируйте версии и оставляйте рискованные инструменты в режиме “ask”.

Четыре базовых элемента вкратце

Элемент Что это, в одну строку Представьте это как Когда агент это читает Сколько это стоит Пример
AGENTS.md (CLAUDE.md в Claude Code) Markdown-файл с внутренними правилами для одного проекта Справочник сотрудника В начале каждой сессии, полностью Вся его длина, в каждом запросе “Используйте британское написание. Запускайте тесты, прежде чем сказать, что закончили.”
Навык Папка с рецептом SKILL.md , плюс необязательные скрипты и справочные материалы Карточка с рецептом в скоросшивателе Имя и описание в начале; полный рецепт — только когда он нужен для задачи Около 100 токенов на навык, пока он не используется “Как мы пишем примечания к релизам”
MCP-сервер Небольшая программа, которая даёт агенту новые инструменты Набор ключей и адаптеров Список инструментов в начале (если ваш агент не откладывает его); отдельные инструменты при вызове Описания инструментов, часто в каждом запросе Задачи в GitHub, настоящий браузер, актуальная документация библиотек
Плагин или расширение Набор навыков, MCP-серверов и иногда хуков Стартовый набор Зависит от того, что внутри Сумма его частей Superpowers, стартовый набор от производителя
Навыки агентов и MCP-серверы: AGENTS.md как постоянно загружаемый справочник, навыки как карточки рецептов, загружаемые по требованию, MCP-серверы как инструменты для GitHub, браузера и актуальной документации, а плагины как готовые наборы
Четыре строительных блока, один агент. Справочник всегда открыт, карточки с рецептами снимаются с полки, когда нужны, а MCP-серверы — ключи ко всему за пределами терминала.

Содержание


Часть 1 — Agent Skills и MCP-серверы простыми словами

Аналогия с новым сотрудником

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

ИИ-агентам нужно ровно то же самое, и у каждой части теперь есть стандартное название:

  • Справочник — это AGENTS.md (в Claude Code его версия называется CLAUDE.md).
  • Рецепты — это навыки.
  • Ключи — это MCP-серверы.
  • Приветственные наборы — это плагины, в некоторых агентах их называют расширениями.

Остальная часть руководства посвящена рецептам и ключам, потому что именно там кроется большая часть путаницы.

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

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

release-notes/
├── SKILL.md          ← обязательно: название, описание, инструкции
├── references/       ← необязательно: более длинные документы, читаются только при необходимости
├── scripts/          ← необязательно: код, который агент может запускать
└── assets/           ← необязательно: шаблоны, изображения, файлы данных

Этот SKILL.md содержит короткий заголовок между двумя --- строками (этот заголовок называется front matter), а затем идут обычные инструкции:

---
name: release-notes
description: Пишет заметки "What's New" для App Store из последних коммитов. Используйте, когда просят заметки о выпуске, список изменений или текст "что нового".
---

# Заметки о выпуске

1. Прочитайте коммиты с момента последнего git-тега.
2. Оставьте только те изменения, которые заметит пользователь.
3. Напишите от трёх до пяти коротких пунктов простым языком, всего не более 400 символов.

Открытый стандарт требует два поля. Поле назвать может состоять только из строчных букв, цифр и дефисов, иметь длину не более 64 символов и совпадать с именем папки. Поле описание может содержать до 1 024 символов и должно объяснять, что делает навык и когда его применять, потому что именно по описанию агент решает, открывать ли навык вообще.

Почему можно установить десятки навыков: трюк с тремя слоями

Навыки загружаются слоями, что стандарт называет progressive disclosure. Представьте книжную полку:

  1. Задние обложки. В начале сессии агент читает только название и описание каждого навыка. Спецификация отводит на это около 100 токенов на навык. (Токен — это примерно короткое слово или его часть; в токенах модели измеряют свою рабочую память.)
  2. Глава. Когда задача совпадает с описанием, агент читает весь файл навыка SKILL.md. Стандарт рекомендует держать его в пределах 5 000 токенов и 500 строк.
  3. Приложение. Файлы справки и скрипты загружаются только в том случае, если на них ссылаются инструкции.

Поэтому сотня неиспользуемых навыков стоит гораздо меньше, чем один длинный свод правил. Но и бесплатным это не назовёшь: описания накапливаются, и агенты их ограничивают. Codex ограничивает исходный список навыков 2% рабочей памяти модели (8 000 символов, если размер определить не удаётся), а Claude Code обрезает текст каждого навыка в списке на 1 536 символах. Устанавливайте то, что будете использовать.

Что такое MCP-сервер

MCP (Model Context Protocol) — открытый стандарт для подключения ИИ-агентов к инструментам и данным. Anthropic представила его в ноябре 2024 года и в декабре 2025 года передала новому Agentic AI Foundation при Linux Foundation вместе с AGENTS.md от OpenAI и goose от Block.

На MCP-сервер — это небольшая программа, которая говорит вашему агенту: “вот инструменты, которые я предлагаю”. Сервер GitHub может предлагать create_issue и search_code; сервер браузера предлагает navigate и take_screenshot; сервер документации предлагает query_docs. Ваш агент — это MCP-клиент: он показывает модели список, а когда модель хочет использовать инструмент, агент проверяет ваши разрешения, просит сервер выполнить его и передаёт результат обратно.

Серверы бывают двух видов:

  • Локальные серверы работают на вашем собственном компьютере. Агент запускает их командой вроде npx @playwright/mcp@latest и общается с ними через ввод и вывод программы (техническое название — stdio).
  • Удалённые серверы работают на компьютерах провайдера. Вы подключаетесь по веб-адресу, например https://mcp.context7.com/mcp, и обычно входите через браузер или вставляете ключ API. Техническое название такого подключения — Streamable HTTP.

Вот в чём подвох. У каждого инструмента есть имя, описание и список параметров, написанные для чтения моделью. Если ваш агент не откладывает их, эти описания передаются с каждым запросом, и двадцать серверов по десять инструментов в каждом делают каждый ответ медленнее, дороже и менее точным. В части 7 рассказано, что с этим делает каждый агент.

AGENTS.md и плагины, коротко

AGENTS.md — это обычный файл Markdown в корневой папке проекта, который агент читает в начале каждой сессии: назначение проекта, его команды, его непреложные правила. OpenCode, Codex, Cursor и GitHub Copilot читают его напрямую. Claude Code читает CLAUDE.md вместо него, и его документация предлагает CLAUDE.md который просто импортирует другой файл строкой вида @AGENTS.md. Поскольку он загружается каждый раз, держите его коротким, а всё, что относится к конкретным задачам, переносите в навыки.

Плагины объединяют остальные части. Плагин Claude Code может содержать навыки, субагентов, хуки (скрипты, запускаемые по событиям) и серверы MCP и LSP. У Codex, Cursor, GitHub Copilot CLI и Hermes Agent тоже есть плагины, а Gemini CLI называет их расширениями. Часть 9 посвящена им.

Карманный глоссарий

Слово Что это значит здесь
Агент (или harness) Программа, с которой вы общаетесь: OpenCode, Claude Code, Codex и так далее. Она запускает модель, читает файлы и вызывает инструменты
Модель ИИ, который думает, например GLM, Claude или GPT
Контекстное окно Рабочая память модели на один запрос. Всё, что вы загружаете, конкурирует за неё
Токен Единица, в которой модели считают текст; примерно короткое слово или его часть
Навык Папка с рецептом SKILL.md файл, который учит агента одному делу
Front matter Заголовок в начале SKILL.md, между двумя --- строками
MCP-сервер Программа, которая даёт агенту инструменты через Model Context Protocol
Инструмент Одно действие, которое предлагает сервер MCP, например create_issue
stdio / Streamable HTTP Как агент общается с локальным и удалённым сервером
OAuth Сценарий “Вход через…” в браузере, который даёт агенту токен без вставки пароля
Область проекта / глобальная область Установлено только для одного проекта или для всех проектов на компьютере
Файл блокировки Квитанция со списком того, что вы установили, откуда и с отпечатком каждого навыка
Симлинк Ярлык на папку. CLI skills хранит одну настоящую копию и связывает с ней агентов

Часть 2 — Навык, MCP-сервер или AGENTS.md? Тест из пяти вопросов

Когда вы хотите, чтобы агент делал что-то лучше, задайте эти вопросы по порядку и остановитесь на первом “да”. Только у вопроса 4 есть продолжение:

  1. Должно ли это действовать для каждой задачи в этом проекте? Запишите это в AGENTS.md. “Пишите по-британски” и “запускайте тесты, прежде чем говорить, что готово” — сюда.
  2. Должно ли это быть принудительно, а не просто рекомендовано? Используйте правило разрешений или хук. Навыки и AGENTS.md — это инструкции, а модель может игнорировать инструкции. “Никогда не пушить в main” требует deny правила.
  3. Это знание, нужное только для некоторых задач? Напишите или установите навык. Процедуры релиза, чек-листы ревью, ваш фирменный голос и рабочий процесс с тестами впереди — всё это навыки.
  4. Нужен ли агенту живой доступ к системе за пределами его файлов? Ваши отчёты о падениях за логином, браузер, которым он может управлять, приложение для управления проектами. Если так, задайте вопрос 5, прежде чем браться за сервер.
  5. Есть ли уже хороший инструмент командной строки для этой системы? Если да, навык, который учит агента этому инструменту, обычно лучше сервера: агент уже умеет запускать команды, CLI ничего не стоит, пока им не пользуются, а его вывод можно отфильтровать, прежде чем он дойдёт до модели. Если хорошего CLI нет, если ваш агент не умеет запускать команды или если задача интерактивная (например, управление браузером), добавьте MCP-сервер.

Вот этот тест, применённый к десяти повседневным желаниям:

Вы хотите, чтобы агент… Используйте Почему
Всегда писать по-британски AGENTS.md Относится к каждой задаче
Никогда не пушить в ветку main Правило разрешений Это должно быть принудительно, а не рекомендовано
Писать заметки о релизе так, как вам нравится Навык Знание, нужное время от времени
Следовать строгому рабочему процессу с тестами впереди Навык (в Superpowers он есть) Процедура для некоторых задач
Читать и создавать задачи GitHub Навык, который учит gh, или MCP-сервер GitHub gh дешевле; сервер подходит агентам, которые не умеют запускать команды
Смотреть актуальную документацию библиотеки MCP-сервер (Context7) или его CLI с навыком (ctx7) В обоих случаях живые данные
Пройти по веб-приложению и сделать скриншоты MCP-сервер (Playwright) Нужен запущенный браузер, которым агент может управлять
Проверить сбои за прошлую ночь MCP-сервер (Sentry) Живые данные, доступные только после входа
Собрать PDF-отчёт по вашему шаблону Навык, внутри которого скрипт и шаблон assets/ Процедура плюс встроенный инструмент
Держать подальше от ваших .env файлов Правило разрешений Это должно соблюдаться принудительно

Навыки и MCP-серверы не соперники. В некоторых лучших конфигурациях они работают в паре: навык объясняет когда и как как пользоваться инструментами сервера, а работу выполняет сервер. Codex даже позволяет навыку объявить MCP-серверы, от которых он зависит, в необязательном agents/openai.yaml .

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

Часть 3 — Где каждый агент ищет навыки

Каждый агент ищет в местах двух видов. Папки проекта находятся внутри вашего репозитория, поэтому навыки путешествуют вместе с кодом и достаются вашим коллегам. Личные папки находятся в вашей домашней папке и действуют для всех проектов на компьютере. Большинство инструментов называют личную установку глобальной.

В 2026 году агенты сошлись на одном общем месте: .agents/skills в проекте и ~/.agents/skills в вашей домашней папке. Положите туда навык, и большинство агентов найдут его без лишней работы.

Агент Папки проекта Личные папки Вызвать навык вручную Стоит знать
OpenCode .opencode/skills, .agents/skills, .claude/skills ~/.config/opencode/skills, ~/.agents/skills, ~/.claude/skills Упомянуть @skill-id в вашем промпте ID — это имя папки. Ограничьте навыки через навык разрешение
Claude Code .claude/skills ~/.claude/skills /skill-name Не читает .agents/skills. Навыки плагинов отображаются как /plugin-name:skill-name
Codex .agents/skills, в каждой папке от места запуска до корня репозитория ~/.agents/skills, плюс /etc/codex/skills для администраторов $skill-name, или /skills Поставляется со встроенным $skill-installer
Gemini CLI .agents/skills, .gemini/skills ~/.agents/skills, ~/.gemini/skills /skills list; модель спрашивает ваше разрешение перед активацией .agents/skills побеждает, когда два навыка имеют одинаковое имя
Cursor .agents/skills, .cursor/skills (и читает .claude/skills и .codex/skills) ~/.agents/skills, ~/.cursor/skills /skill-name A paths ограничивает навык подходящими файлами
GitHub Copilot .github/skills, .agents/skills, .claude/skills ~/.copilot/skills, ~/.agents/skills Загружает навыки, когда они нужны Работает в Copilot CLI, облачном агенте и режиме агента в VS Code и JetBrains
Hermes Agent .hermes/skills, .agents/skills, после того как вы выполните hermes skills trust ~/.hermes/skills, а также любые папки, указанные в skills.external_dirs /skill-name, и до пяти подряд Сканирует каждую установку из хаба на вредоносное содержимое

Пути из документации каждого агента на 15 ноября 2026 года. Агенты регулярно добавляют новые расположения; если что-то не отображается, проверьте страницу навыков вашего агента.

Три детали, которые избавят от путаницы

  • Claude Code — исключение. Он читает только .claude/skills и ~/.claude/skills. CLI skills делает это за вас, создавая ссылку из папки Claude Code на общую копию. Если вы копируете навыки вручную, вам придётся самому положить их (или символическую ссылку) в папку Claude Code.
  • Hermes Agent хранит собственную библиотеку. Его основная папка — ~/.hermes/skills. Чтобы он читал и общую папку, добавьте её в ~/.hermes/config.yaml:

yaml skills: external_dirs: - ~/.agents/skills

Или установите с помощью CLI skills, указав -a hermes-agent. Выберите один подход, а не оба, иначе каждый навык у вас будет дважды. – Одинаковые имена приводят к неожиданностям, которые легко не заметить. У каждого агента своё правило, какая копия побеждает. OpenCode регистрирует свои папки в фиксированном порядке, и побеждает последняя, а папка вашего .opencode/skills проекта идёт последней из всех. Claude Code делает наоборот: личный навык побеждает проектный с тем же именем. Gemini CLI предпочитает рабочее пространство пользовательскому и .agents а не .gemini, а Codex просто показывает оба. Решение скучное и надёжное: не держите два навыка с одинаковым именем.

У OpenCode есть две дополнительные возможности, о которых стоит знать. Отдельный файл Markdown в корне папки навыков (например, skills/review.md) тоже считается навыком, а навыки массиве в opencode.jsonc может добавлять дополнительные папки или даже веб-каталог навыков. Моё руководство по OpenCode подробнее разбирает разрешения для навыков.

Где агенты ИИ ищут навыки: общая папка .agents/skills, которую читают Codex, OpenCode, Cursor, Gemini CLI и GitHub Copilot, со ссылками на .claude/skills для Claude Code и ~/.hermes/skills для Hermes Agent
Одна общая папка подходит большинству агентов. Claude Code всегда нужна ссылка, а Hermes Agent — для глобальных навыков; CLI skills создаёт обе.

Часть 4 — навыки CLI: npm для Agent Skills, пошагово

Навыки можно устанавливать, просто копируя папки, и для одного-двух этого достаточно. Но дальше нужен менеджер пакетов: инструмент, который знает, где ищет каждый агент, хранит одну копию вместо пяти, помнит, откуда взялся каждый навык, и сообщает, когда появилась более новая версия. Именно это навыки и делает. Это инструмент командной строки с открытым исходным кодом (MIT) от Vercel Labs, запускается он командой npx skills, а его каталог публичных навыков находится по адресу skills.sh.

Важные факты на 15 ноября 2026 года:

  • Версия 1.8.1, выпущенная 11 ноября. Развивается быстро: от 1.7.5 до 1.8.1 прошло девять дней.
  • Нужен Node.js 22.20 или новее.
  • Поддерживает 79 агентов, включая OpenCode, Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot и Hermes Agent.
  • Устанавливается из GitHub (owner/repo), GitLab, Azure Repos, любого Git-адреса, локальной папки или прямой ссылки на скачивание SKILL.md или архива.

Шаг 0 — Проверьте Node.js и всегда запрашивайте последнюю версию

node --version      # нужен v22.20.0 или новее

Если выводится более старая версия или “command not found”, установите текущий LTS-релиз с nodejs.org. На Mac с Homebrew brew install node тоже подойдёт. На Raspberry Pi версия в списке пакетов самой операционной системы часто слишком старая, поэтому используйте установщики по ссылкам с той же страницы.

Затем сделайте одну привычку автоматической: вводите npx skills@latest а не простой npx skills для всего, что проверяет или обновляет. Простой npx может взять копию, скачанную недели назад, а в этом инструменте версия, которую вы запускаете, меняет поведение команд (самый яркий пример — в части 5).

Шаг 1 — Посмотрите, прежде чем устанавливать

npx skills@latest add vercel-labs/agent-skills --list

--list показывает все навыки в репозитории с их описаниями и ничего не устанавливает. Затем откройте репозиторий в браузере и прочитайте SKILL.md того, что собираетесь установить, а также любые скрипты рядом с ним. На skills.sh страница каждого навыка также показывает результаты аудита безопасности (часть 11).

Шаг 2 — Установите навык для агентов, которыми пользуетесь

# Один навык, для OpenCode и Claude Code, в текущем проекте
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a opencode -a claude-code

# Тот же навык для всех проектов на этом компьютере
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -g -a opencode -a claude-code

# Закрепите тег релиза или полный коммит, чтобы обновления были осознанными
npx skills add owner/[email protected] --skill my-skill

Если не указать --skill и -a и CLI в интерактивном режиме спросит: какие навыки, каких агентов и связать или скопировать. Вот куда всё попадает:

Охват Единственная реальная копия Ссылки для агентов с собственной папкой Запись о том, что вы установили
Проект (по умолчанию) ./.agents/skills/<name> напр. ./.claude/skills/<name> для Claude Code ./skills-lock.json
Глобально (-g) ~/.agents/skills/<name> напр. ~/.claude/skills/<name>, ~/.hermes/skills/<name> ~/.agents/.skill-lock.json

CLI хранит одну реальную копию в .agents/skills, которую большинство агентов читают напрямую, и создаёт ссылки (символические ссылки, по сути ярлыки) для агентов, которые ищут в другом месте. Одна копия — одно обновление. Если ваша система плохо работает с символическими ссылками, а на Windows так бывает, добавьте --copy чтобы вместо этого получить независимые копии.

Шаг 3 — Что установлено

npx skills ls              # навыки этого проекта
npx skills ls -g           # ваши глобальные навыки
npx skills ls -a opencode  # только то, что получает OpenCode
npx skills ls --json       # машиночитаемо, для скриптов

Для навыков проекта текущие версии также показывают статус: отслеживается (совпадает с файлом блокировки), изменён (вы или агент его отредактировали), не отслеживается (нет записи в файле блокировки, например навык, написанный вручную) или отсутствует (есть в файле блокировки, но нет на диске).

Шаг 4 — Найти навыки

npx skills find                    # интерактивный поиск
npx skills find seo                # поиск по ключевому слову
npx skills find react --owner vercel   # только репозитории одной организации

Или просмотрите skills.sh, где навыки ранжируются по числу установок и сгруппированы по темам. Самый устанавливаемый навык там сегодня — find-skills из собственного репозитория Vercel, который учит вашего агента самостоятельно искать навыки. Число установок меняется ежедневно, так что считайте рейтинг подсказкой, а не обзором.

Шаг 5 — Попробовать навык без установки

npx skills use vercel-labs/agent-skills@web-design-guidelines

Эта команда выводит готовый промпт для этого навыка, который можно передать по конвейеру или вставить в агент на том же компьютере. Добавьте --agent claude-code и CLI запустит Claude Code с загруженным навыком. Это хороший способ проверить навык, прежде чем он войдёт в вашу конфигурацию.

Шаг 6 — Удалить навыки

npx skills remove web-design-guidelines            # из этого проекта
npx skills rm --global web-design-guidelines       # из ваших глобальных навыков
npx skills remove --agent claude-code my-skill     # только из одного агента
npx skills remove vercel-labs/agent-skills         # всё из этого источника
npx skills remove                                  # выбрать из списка

npx skills remove --all удаляет все навыки записанные в файле блокировки и пропускает папки, которые не устанавливал, например навыки, написанные вами, так что вашу работу он не удалит.

Шаг 7 — Создать свой

npx skills init my-skill создаёт my-skill/SKILL.md по шаблону. В части 10 разобран полный пример.

Весь инструмент на одной карточке

Я хочу… Команда
Посмотреть, что предлагает репозиторий npx skills@latest add owner/repo --list
Установить один навык в этот проект npx skills add owner/repo --skill name
Установить для каждого проекта add -g
Выберите агентов add -a opencode -a claude-code (или --agent '*' для всех)
Установить без вопросов add -y
Зафиксировать версию npx skills add owner/[email protected] --skill name
Показать установленные навыки npx skills ls · npx skills ls -g
Поиск npx skills find keyword
Проверить обновления (только чтение) npx skills@latest check · add -g или -p
Установить обновления npx skills update · -g · -p · -y · или назовите навыки
Удалить npx skills remove name · add -g для глобальных
Восстановить навыки проекта из его файла блокировки npx skills install
Создать новый навык npx skills init name

Команды для skills 1.8.1. npx skills install (алиас для experimental_install) и experimental_sync для навыков, поставляемых внутри npm-пакетов, помечены как экспериментальные и могут измениться.

Шпаргалка по CLI npx skills: команды add, list, find, use, check, update, remove и init с самыми полезными флагами, места установки в проекте и глобально, а также два lock-файла
CLI skills на одной карточке. Две привычки делают большую часть работы: --list перед установкой и @latest при каждой проверке или обновлении.

Что такое файл блокировки и стоит ли его коммитить?

Файл блокировки — это квитанция. Для каждого навыка он записывает, откуда тот взялся, и отпечаток его папки (технически хеш: короткий код, который меняется при изменении любого файла в папке). CLI различает два вида:

  • skills-lock.json в проекте. Закоммитьте его в Git. На другом компьютере или у коллеги, npx skills install восстанавливает ровно те же навыки, а --frozen-lockfile (по умолчанию в CI) отказывается продолжать, если что-то расходится. Благодаря этому навыки проекта воспроизводятся одинаково, как package-lock.json это делает для кода.
  • ~/.agents/.skill-lock.json для ваших глобальных навыков. Он принадлежит вашей учётной записи (или лежит в $XDG_STATE_HOME/skills/.skill-lock.json если вы задали эту переменную). Не редактируйте его вручную и учтите, что у каждого пользователя на компьютере он свой — это важно в части 6.

Коротко о телеметрии

CLI отправляет анонимные данные об использовании. Согласно документации, имена репозиториев GitHub и навыков передаются только когда GitHub подтверждает, что репозиторий публичный; другие виды источников тоже могут называться. Чтобы отключить это, добавьте export DISABLE_TELEMETRY=1 (или DO_NOT_TRACK=1) в профиль вашей оболочки. Это также отключает проверки безопасности, которые CLI выполняет для публичных навыков, так что решите, что для вас важнее.

Другие установщики, с которыми вы встретитесь

CLI skills — не единственный способ. У нескольких агентов и инструментов есть свои установщики, и все они следуют одному открытому стандарту:

Инструмент Пример Полезно знать
GitHub CLI (gh skill, версия 2.90 или новее, в режиме предпросмотра) gh skill install owner/repo skill-name --agent claude-code gh skill preview показывает навык перед установкой; --pin фиксирует версию
Hermes Agent hermes skills install <identifier> Его хаб включает skills.sh, и каждая установка проходит проверку безопасности
Gemini CLI gemini skills install <git-url> --scope workspace для одного проекта; запрашивает согласие, если не передан --consent
Codex $skill-installer <name> Встроенный системный навык
Claude Code /plugin install name@marketplace Плагины объединяют навыки с MCP-серверами и хуками (часть 9)

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


Часть 5 — “Мой набор навыков обновили два дня назад. Как узнать, что он у меня есть?”

Именно такой вопрос у меня возник, когда Superpowers, популярная библиотека навыков от Jesse Vincent, объявила об обновлении. npx skills ls перечисляет имена, а не версии, поэтому ничего не может сказать. Вот как CLI на самом деле это узнаёт.

Как работает проверка

Когда вы устанавливаете навык, CLI сохраняет отпечаток его папки в lock-файле. При проверке он запрашивает у источника (обычно GitHub) отпечаток той же папки на сегодня. Отпечаток совпадает: всё актуально. Отличается: есть обновление. Он не сравнивает номера версий или даты, поэтому работает даже с навыками, у которых нет ни того, ни другого.

cd /tmp                        # or a project folder, but never your home folder
npx skills@latest check -g     # your global skills

cd ~/code/my-app
npx skills@latest check -p     # this project's skills

Типичный результат в 1.8.1 выглядит так:

↑ у brainstorming есть обновление
↑ у writing-plans есть обновление
2 навыка можно обновить; запустите npx skills update для установки

check также сообщает о навыках проекта, файлы которых больше не совпадают с lock-файлом (есть локальные изменения), и завершается с кодом ошибки всякий раз, когда что-то устарело или изменено, так что его можно использовать, чтобы остановить сборку CI, которая отклонилась от ожидаемого состояния.

check изменилось в ноябре, поэтому запускайте последнюю версию

Начиная с версии 1.7.5 (2 ноября 2026 г.), check только сообщает. В более ранних версиях, как минимум с 1.5.18 до 1.7.4, check было просто другим названием для update: он спрашивал “Update scope?” и устанавливал обновления по ходу дела. Если вы пользовались npx skills check до ноября и удивлялись, почему он “обновляет” всё подряд, — вот почему. Используйте npx skills@latest check и получите поведение только для чтения.

Ещё две детали, на которых люди спотыкаются:

  • check сам выбирает одну область. Если в папке, где вы находитесь, есть skills-lock.json файл или .agents/skills папка с навыком внутри, он проверяет проект навыки; в противном случае он проверяет глобальной навыки. Добавьте -g или -p чтобы указать, какие именно.
  • Опции “обновить всё из одного репозитория” нет. Либо обновляйте всё в пределах области, либо перечислите навыки по именам.

Затем обновите

npx skills update                      # спросит: проект, глобальные или и то и другое
npx skills update -g                   # все глобальные навыки
npx skills update -p                   # все навыки проекта
npx skills update brainstorming writing-plans -g   # только эти
npx skills update -y                   # без вопросов: проект, если вы в нём, иначе глобальные

Прочитайте изменения, прежде чем обновлять что-то важное. Откройте историю коммитов репозитория на GitHub и посмотрите, что изменилось в папках навыков: обновление — это новые инструкции, которые ваш агент будет выполнять с вашими правами.

Если вы установили его как плагин, обновляйте его как плагин

Многие наборы навыков теперь распространяются как плагины, и Superpowers — хороший пример. В его README для почти каждого агента указан свой способ установки:

Агент Установка Superpowers по его README Как он обновляется
Claude Code /plugin install superpowers@claude-plugins-official Автоматически, из официального маркетплейса Anthropic
Codex CLI /plugins, найдите “superpowers”, пункт Install Plugin Через менеджер плагинов
Cursor /add-plugin superpowers в чате агента Через менеджер плагинов
Gemini CLI gemini extensions install https://github.com/obra/superpowers gemini extensions update superpowers
GitHub Copilot CLI copilot plugin marketplace add obra/superpowers-marketplace, затем copilot plugin install superpowers@superpowers-marketplace Через менеджер плагинов
Hermes Agent hermes plugins install obra/superpowers --enable Через менеджер плагинов
OpenCode Добавьте "superpowers@git+https://github.com/obra/superpowers.git" в список плагинов, который указан в opencode.json, как описано в его руководстве по установке в OpenCode После перезапуска; очистите кеш пакетов OpenCode, если новая версия не появилась, или добавьте #v5.0.3-теги такого вида, чтобы закрепить версию.

Из README Superpowers и его руководства по установке в OpenCode, проверено 15 ноября 2026 г.

Я установил Superpowers на свой Mac с помощью npx skills -g, так что у меня обновление идёт через skills CLI. Это нормально. Ненормально другое: устанавливать один и тот же пакет по двум каналам — вы получите две копии каждого навыка с одинаковыми именами и никак не узнаете, какую из них выберет агент.

Как работает npx skills check: lock-файл хранит отпечаток каждой папки навыка, check сравнивает его с той же папкой в источнике и сообщает об обновлениях, а update их устанавливает
check сравнивает отпечатки, а не номера версий. Начиная с 1.7.5 он только сообщает; update — это команда, которая что-то меняет.

Часть 6 — Пять реальных проблем с моего Mac и Raspberry Pi и как их решить

Всё в этой части случилось со мной летом 2026 года, на версии 1.5 CLI. С тех пор каждая проблема проверена по исходному коду текущего выпуска 1.8.1, так что вы увидите, какие из них исправлены, а какие всё ещё кусаются. Вывод терминала настоящий; я его сократил и убрал имена машин.

Проблема 1: “Все глобальные навыки актуальны”, когда не проверено ни одного

На моём Mac npx skills check выдала это:

graham@mac my-app % npx skills check
◇  Область обновления
│  Обе
Проверка обновлений навыков…
Глобальные навыки
Проверка навыков из источника: anthropics/skills
│  Достигнут лимит запросов к API GitHub; проверка существующей аутентификации gh…
  ✗ Не удалось получить дерево для anthropics/skills
Проверка навыков из источника: vercel-labs/skills
  ✗ Не удалось получить дерево для vercel-labs/skills
…                                  (ещё шесть источников, и все ✗)
Проверка навыков из источника: obra/superpowers
  ✗ Не удалось получить дерево для obra/superpowers
✓ Все глобальные навыки актуальны

Что произошло. Чтобы проверить репозиторий, CLI запрашивает у API GitHub список файлов репозитория. GitHub разрешает 60 анонимных запросов в час на один интернет-адрес, а мой лимит на этот час уже был исчерпан (инструмент говорит об этом в первой строке), поэтому каждая проверка завершилась неудачей. Последняя строка считает только те обновления, которые инструмент нашёл, а он не нашёл ни одного, и всё равно напечатал зелёную галочку. Старая версия также пыталась втихую позаимствовать вход из GitHub CLI (это та самая строка “checking existing gh authentication”); раз все запросы всё равно провалились, заимствовать было явно нечего.

Это исправлено? Частично. Версия 1.8.1 старается сильнее, прежде чем сдаться: сначала анонимно, затем токен из вашего окружения, затем собственный вход GitHub CLI через gh api, а при проверке обновлений — обычное скачивание через Git как последнее средство. Но исходный код 1.8.1 показывает, что если источник всё ещё не удаётся проверить, итоговая строка по-прежнему считает только найденные обновления. Зелёная галочка под красными крестиками по-прежнему возможна, поэтому читайте строки с ✗.

Решение. Дайте CLI вход — это поднимает лимит до 5 000 запросов в час:

  1. Проще всего: установите GitHub CLI и запустите gh auth login. Текущие версии skills CLI просят gh сделать запрос к API и никогда не видят ваши учётные данные.
  2. Или используйте токен: создайте fine-grained personal access token с доступом только на чтение к публичным репозиториям, затем добавьте его в профиль оболочки (~/.zshrc на Mac, ~/.bashrc на Raspberry Pi):

bash export GITHUB_TOKEN="github_pat_…" # read-only, public repositories

После этого откройте новый терминал. Обращайтесь с токеном как с паролем: никогда не вставляйте его в чат, в skill или в файл, который вы коммитите. 3. Обновите и перепроверьте: npx skills@latest check -g.

Проблема 2: sudo дала мне два хранилища skills и ошибку npm

На своём Raspberry Pi я взял в привычку набирать sudo su первым. Вот что из этого вышло:

graham@pi:~ $ sudo su
root@pi:/home/graham# npx skills update
npm error config prefix cannot be changed from project config: /home/graham/.npmrc.
◇  Update scope
│  Both
Checking for skill updates…
Global Skills
…
Found 6 global update(s)
…
Project Skills
Updating for: Universal, Claude Code, Hermes Agent
Refreshing 7 skill(s)…

А через мгновение, вернувшись под своим обычным пользователем:

graham@pi:~ $ ls ~/.agents/skills | wc -l
7
graham@pi:~ $ sudo ls /root/.agents/skills | wc -l
37

Что произошло. sudo su превращает вас в root, а у root есть собственная домашняя папка, /root. Skills хранятся отдельно для каждого пользователя, поэтому глобальные skills root лежат в /root/.agents/skills а мои в /home/graham/.agents/skills. Всё, что я когда-либо устанавливал глобально под root, попадало в хранилище root: 37 skills там, 7 у меня. Если ваши агенты работают под вашим обычным пользователем, а это обычная настройка, то всё в хранилище root им не видно.

У ошибки npm та же причина. Под root личный файл настроек npm — это /root/.npmrc, поэтому /home/graham/.npmrc лежащий в папке, где я находился, читается как файл проект настроек. Собственный код npm не позволяет файлу проекта менять prefix параметр, и записывает именно эту ошибку. Есть и третий риск, который вы не увидите сразу: всё, что root записывает в вашу домашнюю папку, оказывается принадлежащим root, и ваш обычный пользователь потом не может это обновить.

Решение.

  1. Выйдите из root: type exit. С этого момента запускайте CLI и своих агентов от собственного имени.
  2. Выясните, под каким пользователем работают ваши агенты. Важна та домашняя папка, в которой лежат их настройки:

bash ls -d ~/.claude ~/.config/opencode ~/.hermes 2>/dev/null sudo ls -d /root/.claude /root/.config/opencode /root/.hermes 2>/dev/null

  1. Переустановите skills root под своим пользователем, из их исходных источников. Копирование файлов перенесло бы с собой владельца root и устаревшие записи. Переустановка создаёт чистый lock-файл. Сначала перечислите источники, которые использовал root:

bash sudo grep '"source"' /root/.agents/.skill-lock.json | sort -u

Затем из папки проекта или из /tmp, выполните npx skills add <owner/repo> -g -a <your agents> для каждого, который вам ещё нужен. 4. Верните себе собственные папки, на случай, если root писал в них:

bash sudo chown -R "$(id -un)":"$(id -gn)" ~/.agents ~/.claude ~/.hermes ~/.config/opencode 2>/dev/null

  1. Только когда всё работает от вашего пользователя, удалите копию, созданную root, с помощью sudo rm -rf /root/.agents.

Если вы используете sudo , потому что без него не проходят глобальные установки npm, исправьте лучше вот что: направьте префикс npm в папку, которой владеете сами (npm config set prefix ~/.npm-global, затем добавьте ~/.npm-global/bin в свой PATH). Почти наверняка именно это prefix строка в моём .npmrc и делала.

Проблема 3: запустите из своей домашней папки — и она станет “проектом”

Снова под своим пользователем, в своей домашней папке:

graham@pi:~ $ npx skills check
Need to install the following packages:
[email protected]
Ok to proceed? (y) y
…
Global Skills
No global skills tracked in lock file.
Install skills with npx skills add <package> -g
Project Skills
Updating for: Universal, Claude Code, Hermes Agent
Refreshing 7 skill(s)…

Что произошло. CLI считает папку проектом, если в ней есть файл skills-lock.json или папка .agents/skills со скиллом внутри. В вашей домашней папке есть ~/.agents/skills, потому что именно там живут глобальные скиллы, поэтому, если запустить его из ~ CLI увидит проект. А если вы когда-нибудь запускали npx skills add в своей домашней папке без -g, вы создали там настоящую проектную установку с собственным ~/skills-lock.json, чья папка скиллов — та же самая, которую использует глобальная установка. Именно это и произошло на моём Pi: семь скиллов числились как “проект” в домашней папке, а в моём собственном глобальном lock-файле не было ровно ничего.

У сообщения “В lock-файле нет отслеживаемых глобальных скиллов” три частые причины: вы ни разу не устанавливали с флагом -g, вы устанавливали с флагом -g от имени другого пользователя (root, через sudo), либо lock-файл был удалён. Если вы где-то читали, что generate-lock команда его пересобирает, — не существует: такой команды нет ни в версии 1.5, ни в 1.8.

Решение.

  • Запускайте CLI из папки проекта или /tmp, никогда из ~, и передавайте -g или -p чтобы ему не приходилось угадывать.
  • Чтобы распутать “проект” в домашней папке, переустановите нужные скиллы с помощью -g из другой папки (они попадут в то же место, но теперь будут записаны в ваш глобальный lock-файл), затем удалите ~/skills-lock.json. Не запускайте npx skills remove и ~ для этого: в вашей домашней папке папка проекта и глобальная папка — это одна и та же папка.

Проблема 4: сообщение “No matching skills found” из-за двоеточия

graham@pi:~ $ npx skills remove ckm:banner-design ckm:brand ckm:design \
  ckm:design-system ckm:slides ckm:ui-styling
◇  Found 7 unique installed skill(s)
■  No matching skills found for: ckm:banner-design, ckm:brand, ckm:design, ckm:design-system, ckm:slides, ckm:ui-styling

Что произошло. Эти навыки отображаются как ckm:banner-design, но двоеточие — рискованный символ в имени папки, поэтому CLI сохранил их как ckm-banner-design: он приводит имя к нижнему регистру и превращает всё, кроме букв, цифр, точек и подчёркиваний, в дефис. Версия 1.5.18 сравнивала введённое мной с именами папок буквально, поэтому совпадений не было.

Это исправлено? Да. Текущие версии так же преобразуют ваш ввод перед сравнением, поэтому ckm:brand и ckm-brand работают оба, а когда совпадений нет, 1.8.1 печатает имена, которые собираются установлены.

Решение. Запуск npx skills ls (или ls ~/.agents/skills) — так вы увидите настоящие имена — или запустите npx skills remove без аргументов и выберите из списка. Проверьте и область действия: если из папки проекта удалить навык, записанный в глобальном lock-файле, теперь вам сообщат, что нужно добавить -g.

Проблема 5: шесть навыков не обновляются, а один из того же репозитория работает

Refreshing 7 skill(s)…
✗ Failed to check for deleted skills from nextlevelbuilder/ui-ux-pro-max-skill
Updating ckm:banner-design…
  ✗ Failed to update ckm:banner-design
…                                  (five more ✗)
Updating ui-ux-pro-max…
  ✓ Updated ui-ux-pro-max

Что произошло. Чтобы обновить навык, CLI снова ищет его в исходном репозитории. Шесть из моих семи навыков из того репозитория найти не удалось, а седьмой обновился нормально. Когда большая часть навыков из одного источника не обновляется, а один обновляется, это обычно значит, что пропавшие переименовали, переместили или удалили upstream. README того репозитория сегодня описывает один навык, ui-ux-pro-max, а баннеры, фирменный стиль и слайды упоминает только как функции платного тарифа — что согласуется с тем, что эти шесть покинули бесплатный репозиторий.

Решение. Посмотрите, что источник предлагает сейчас, и удалите то, чего больше нет:

npx skills add nextlevelbuilder/ui-ux-pro-max-skill --list
npx skills remove ckm-banner-design ckm-brand ckm-design ckm-design-system ckm-slides ckm-ui-styling

Текущие версии CLI замечают навыки, удалённые upstream, и предлагают почистить их при обновлении, а при удалении убирают отсутствующие навыки из lock-файла. Заодно проверьте дубликаты: если у вас есть ещё и обычный brand навык рядом с ckm-brand, оставьте один. Два навыка с почти одинаковыми описаниями сбивают выбор агента и тратят его бюджет на листинг.

Бонус: Claude Code не видит навык, установленный CLI

  • Проверьте ссылку. Claude Code читает только свои папки, поэтому ls -la ~/.claude/skills (или .claude/skills в проекте) должен показать навык, обычно как ссылку в .agents/skills. Несколько релизов ветки 1.5 исправляли ошибки со ссылками Claude Code (1.5.16 и 1.5.20), так что если ссылки нет, переустановите с помощью npx skills@latest add … -a claude-code.
  • Проверьте, что файл начинается правильно. Открывающая --- строка front matter должна быть самой первой строкой в SKILL.md, иначе Claude Code считает весь файл простым текстом.
  • Перезагрузите. Claude Code подхватывает изменённые навыки на лету, но папка навыков, созданная после запуска сессии, требует /reload-skills. Затем /skills показывает, что загружено.
Решение проблем с npx skills: пять реальных ошибок и их исправлений — от ложного «всё обновлено» после лимита запросов GitHub до sudo, создающего второе хранилище навыков, домашней папки, принятой за проект, и навыков, удалённых в источнике
Пять ошибок, пять исправлений. Большинство из них сводится к двум правилам: читайте строки с ✗ и никогда не запускайте CLI от root или из своей домашней папки.

Часть 7 — MCP-серверы без жаргона

Что происходит, когда вы подключаете сервер

  1. Вы добавляете сервер в настройки вашего агента: команду для локального сервера, веб-адрес для удалённого.
  2. Когда начинается сессия, агент запускает локальный сервер или подключается к удалённому и выполняет вход, если сервер этого требует.
  3. Сервер перечисляет свои инструменты, и агент передаёт их описания модели.
  4. Когда задаче нужен инструмент, модель запрашивает его, ваш агент проверяет ваши правила разрешений (и может спросить вас), сервер выполняет работу, а результат возвращается в диалог.

Локальный или удалённый?

Локальный сервер (stdio) Удалённый сервер (Streamable HTTP)
Где работает На вашем компьютере, запускается агентом На компьютерах провайдера
Вы добавляете Команду, например npx @playwright/mcp@latest Адрес, например https://mcp.context7.com/mcp
Вход Обычно ключ API в переменной окружения Обычно OAuth в браузере или ключ в заголовке
Требуется Node.js, Python или Docker — в зависимости от сервера Подключение к интернету
Кому подходит То, что находится на вашей машине: браузер, файлы, локальная база данных Облачные сервисы: GitHub, Sentry, документация, инструменты проекта
На что обратить внимание Работает с полными правами вашего пользователя Ваши данные уходят этому провайдеру

В старых руководствах вы можете встретить третий тип — SSE. Документация Claude Code помечает его как устаревший; используйте HTTP-адрес, если сервер предлагает оба варианта.

Пара слов о версиях

Текущая спецификация MCP, выпущенная 28 июля 2026 года, — самая крупная ревизия с момента запуска протокола: её ядро теперь не хранит состояние, что позволяет запускать удалённые серверы за обычными балансировщиками нагрузки. Вам редко придётся об этом задумываться, потому что клиенты и серверы договариваются, на какой ревизии общаться, а старые серверы продолжают работать. OpenCode — единственное место, где вы это увидите: у каждого сервера есть protocol — параметр (legacy по умолчанию, auto, или 2026-07-28), а пулинг соединений работает только с самой новой ревизией.

Счёт за контекст и как его уменьшить

Каждый инструмент, который предлагает сервер, приходит с описанием, написанным для модели. По словам самого OpenCode, “Инструменты MCP расходуют контекст модели, поэтому добавляйте только те серверы, которые вам нужны.” Два агента теперь смягчают эту цену по умолчанию:

  • Claude Code использует поиск инструментов. В начале сессии он загружает только имена инструментов и инструкции каждого сервера, а полное определение инструмента подтягивает, когда Claude действительно его ищет.
  • OpenCode использует Code Mode, который группирует инструменты каждого сервера за одной записью вместо того, чтобы перечислять каждый инструмент отдельно. Он включён, если вы не задали "codemode": false для сервера.

Во всех остальных случаях, сверх этих значений по умолчанию, ваши рычаги — вот эти:

Агент Отключить сервер Скрыть ненужные инструменты
OpenCode "disabled": true, или /mcps на одну сессию A deny правило на <server>_<tool> в разрешениях
Claude Code claude mcp remove <name> (/mcp показывает статус) A deny правило разрешения на mcp__<server>__<tool>; ENABLE_TOOL_SEARCH определяет, сколько загружается заранее
Codex enabled = false enabled_tools и disabled_tools
Gemini CLI gemini mcp disable <name> (добавьте --session для одной сессии) includeTools и excludeTools
Cursor Переключатель сервера в разделе Customize (Администраторы могут задать списки разрешённых инструментов)
Hermes Agent enabled: false tools.include и tools.exclude

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

Четыре сервера, с которых стоит начать

Сервер Что это даёт вашему агенту Тип Адрес или команда Вход
Context7 Актуальная документация по конкретным версиям популярных библиотек и фреймворков Удалённый https://mcp.context7.com/mcp Ничего не нужно; бесплатный ключ API повышает лимиты
GitHub (официальные) Issues, pull requests, поиск по коду, Actions Удалённый https://api.githubcopilot.com/mcp/ OAuth, если ваш агент его поддерживает, или персональный токен доступа
Playwright Настоящий браузер, который агент может открыть, пройти по ссылкам и сделать скриншот Локальный npx @playwright/mcp@latest Нет
Sentry Ваши реальные ошибки и сбои Удалённый https://mcp.sentry.dev/mcp OAuth

Где искать ещё:

  • Официальный MCP Registry, который поддерживают участники протокола, содержит список опубликованных серверов.
  • Документация самих ваших инструментов. Большинство сервисов теперь публикуют официальный сервер; поищите в их документации “MCP”.
  • Каталог вашего агента. В Hermes Agent есть hermes mcp catalog, а многие плагины Claude Code поставляются со своими серверами.

Отдавайте предпочтение серверам, которые публикует компания, владеющая сервисом. Случайный сервер под названием “github-mcp-pro” заслуживает такого же подозрения, как и случайное расширение для браузера.

Более лёгкий вариант: инструмент командной строки плюс навык

Прежде чем добавлять сервер, проверьте, справляется ли с задачей инструмент командной строки. Сам Context7 предлагает оба пути: MCP-сервер выше или небольшой CLI с навыком (npx ctx7 setup --opencode, для которого нужен Node.js 22.13 или новее). Собственный gh инструмент GitHub плюс короткий навык покрывает большую часть того, что делает его сервер.

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


Часть 8 — Добавляем MCP-сервер в шести агентах: рецепты для копирования

Каждый рецепт добавляет одни и те же два сервера: Context7 (удалённый) и Playwright (локальный). Любой другой сервер подставляется так же. Там, где у агента есть и команда, и файл настроек, команда просто записывает файл за вас.

OpenCode

opencode mcp add context7 --url https://mcp.context7.com/mcp
opencode mcp add playwright -- npx @playwright/mcp@latest
opencode mcp list

Добавьте --global чтобы сервер был доступен во всех проектах. В opencode.jsonc та же настройка выглядит так:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "context7": {
        "type": "remote",
        "url": "https://mcp.context7.com/mcp",
        "oauth": false
        // With a free API key, add:
        // "headers": { "Authorization": "Bearer {env:CONTEXT7_API_KEY}" }
      },
      "playwright": {
        "type": "local",
        "command": ["npx", "@playwright/mcp@latest"]
      }
    }
  }
}
  • Секреты задаются как {env:NAME}; OpenCode не раскрывает обычный $NAME.
  • Удалённые серверы автоматически пробуют OAuth; oauth: false используется для серверов, которым нужен ключ или которые обходятся без него. Войдите с помощью opencode mcp auth <name>, а при работе через SSH вставьте URL обратного вызова со страницы браузера с ошибкой в приглашение.
  • Внутри сессии /mcps подключается к серверам, отключается от них или выполняет вход.
  • Каждый инструмент становится действием разрешения с именем <server>_<tool>, поэтому { "action": "playwright_*", "resource": "*", "effect": "ask" } заставляет каждое действие браузера сначала запрашивать разрешение.

Claude Code

claude mcp add --transport http context7 https://mcp.context7.com/mcp
claude mcp add playwright -- npx @playwright/mcp@latest
claude mcp list

Этот -- отделяет параметры Claude Code от собственной команды сервера. По умолчанию серверы используют локальную область (вы, в этом проекте). Добавьте --scope user для всех ваших проектов или --scope project чтобы записать .mcp.json файл, который можно закоммитить для вашей команды:

{
  "mcpServers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp"
    },
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    }
  }
}
  • .mcp.json разворачивает ${VAR} и ${VAR:-default}, поэтому ключи остаются в вашей среде, а не в Git.
  • /mcp внутри сессии показывает состояние каждого сервера и обрабатывает вход через OAuth.
  • Claude Code спрашивает подтверждение перед использованием серверов из .mcp.json, так что клонированный репозиторий не может незаметно добавить свои.

Codex

Codex хранит серверы в ~/.codex/config.toml, или в .codex/config.toml внутри проекта, который вы отметили как доверенный:

[mcp_servers.context7]
url = "https://mcp.context7.com/mcp"

[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]
  • Удалённые серверы также можно добавить с помощью codex mcp add context7 --url https://mcp.context7.com/mcp, и codex mcp login <name> выполняет вход через OAuth.
  • Для ключа bearer_token_env_var = "CONTEXT7_API_KEY" читает его из вашей среды.
  • Настройте сервер с помощью enabled_tools и disabled_tools; startup_timeout_sec (по умолчанию 10 секунд) помогает медленным серверам запуститься.

Gemini CLI

gemini mcp add -t http context7 https://mcp.context7.com/mcp
gemini mcp add playwright npx @playwright/mcp@latest
gemini mcp list

gemini mcp add записывает в настройки проекта по умолчанию; добавьте -s user для всех проектов. В settings.json:

{
  "mcpServers": {
    "context7": { "httpUrl": "https://mcp.context7.com/mcp" },
    "playwright": { "command": "npx", "args": ["@playwright/mcp@latest"] }
  }
}
  • httpUrl предназначен для Streamable HTTP; url означает более старый тип SSE.
  • Оставьте trust выключенным. Если установить true, он пропускает все подтверждения для этого сервера.
  • Gemini CLI вырезает переменные, похожие на секреты (имена, содержащие TOKEN, SECRET, PASSWORD или KEY), из окружения сервера, если вы не перечислите их в его env блоке.
  • Для OAuth нужен браузер на той же машине. В недоверенной папке локальные серверы остаются отключёнными, пока вы не запустите gemini trust.

Cursor

Cursor читает .cursor/mcp.json в проекте и ~/.cursor/mcp.json для всего:

{
  "mcpServers": {
    "context7": { "url": "https://mcp.context7.com/mcp" },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    }
  }
}
  • Локальным серверам нужен "type": "stdio".
  • Секреты задаются как ${env:NAME}.
  • Включайте и выключайте серверы переключателями в разделе Настройка.

Hermes Agent

Hermes читает mcp_servers в ~/.hermes/config.yaml:

mcp_servers:
  context7:
    url: "https://mcp.context7.com/mcp"
  playwright:
    command: "npx"
    args: ["@playwright/mcp@latest"]
  • Запуск /reload-mcp после редактирования и hermes mcp test context7 чтобы увидеть, что именно ответил сервер.
  • Для сервисов с OAuth добавьте auth: oauth в HTTP-запись. На машине без графического интерфейса Hermes предлагает вставку кода вручную, проброс портов SSH или вход по коду устройства.
  • Hermes передаёт локальным серверам только переменные, которые вы перечислите в env плюс безопасный базовый набор, а не всё ваше окружение оболочки.
  • Инструменты отображаются как mcp_<server>_<tool>; фильтруйте их с помощью tools.include или tools.exclude.

Проверьте, что это работает, в любом агенте

Задайте вопрос, на который может ответить только сервер: “Используйте Context7, чтобы узнать, как определить маршрут в текущей версии Next.js, и скажите, какой инструмент вы вызвали.” Затем попросите что-нибудь видимое: “Откройте example.com с помощью Playwright и опишите страницу.” Если агент говорит, что у него нет таких инструментов, выведите список серверов (opencode mcp list, claude mcp list, gemini mcp list, hermes mcp test) и поищите неудачное подключение или вход, который так и не завершился.

Как добавить MCP-сервер в OpenCode, Claude Code, Codex, Gemini CLI, Cursor и Hermes Agent: один и тот же сервер Context7 в формате команды или конфига каждого агента, плюс команда для локального сервера
Один сервер, шесть диалектов. Идеи одинаковы; меняются только имена файлов и скобки.

Часть 9 — Плагины: навыки и MCP-серверы в одной упаковке

Устанавливать десять навыков и три сервера по одному быстро надоедает. Плагины объединяют их, и у большинства агентов теперь есть та или иная система плагинов.

Плагины Claude Code

Плагин Claude Code может содержать навыки, субагентов, хуки, MCP-серверы и языковые серверы. Плагины берутся из маркетплейсов, которые представляют собой просто каталоги, размещённые в Git-репозитории:

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills

В сеансе /plugin install сначала открывает сведения о плагине, чтобы вы точно видели, что он добавляет, прежде чем выбрать область: вы (все проекты), этот репозиторий для всех или этот репозиторий только для вас. Из командной оболочки claude plugin install <name>@<marketplace> делает то же самое без сеанса.

Три функции, о которых стоит знать:

  • Стоимость контекста видна. Для плагинов из официального маркетплейса Anthropic панель сведений оценивает, сколько плагин добавляет к каждому сообщению и сколько он добавляет при использовании. claude plugin details <name> показывает цифру на сеанс для всего установленного.
  • Обновления. Официальный маркетплейс Anthropic обновляет плагины автоматически; сторонние маркетплейсы этого не делают, если вы не включите это сами. claude plugin update <name>@<marketplace> обновляет один плагин вручную.
  • Неиспользуемые плагины помечаются. Вкладка «Установленные» группирует плагины, которые вы не использовали в последнее время, что упрощает генеральную уборку.

Плагины в других местах

  • Codex распространяет переиспользуемые навыки через плагины (/plugins в CLI), и плагин также может содержать подключения к MCP-серверам.
  • Gemini CLI называет их расширениями: gemini extensions install <git-url> и gemini extensions update <name>.
  • GitHub Copilot CLI (copilot plugin install) и Hermes Agent (hermes plugins install) имеют команды плагинов, а Cursor поддерживает /add-plugin в чате агента.
  • OpenCode плагины — это пакеты JavaScript или TypeScript, перечисленные в список плагинов, параметре его конфигурации, который может регистрировать навыки и инструменты. Superpowers устанавливается именно так.

Два правила, которые сохраняют порядок в настройке плагинов

  1. Один канал на пакет. Если пакет навыков существует и как плагин, и как обычные навыки, выберите что-то одно. Две копии означают дублирующиеся имена и агента, который берёт то, что увидит первым.
  2. Обновляйте там, где устанавливали. CLI skills ничего не знает о плагинах, а менеджеры плагинов не знают о ~/.agents/skills.

Часть 10 — Пишем первый навык за десять минут

Лучший первый навык решает задачу, которую вы повторяете. Вот один, собранный из части 6: навык, который позволяет любому агенту проверять ваши навыки на обновления безопасно, ни разу не используя sudo и не доверяя зелёной галочке вслепую.

Шаг 1 — создайте папку

mkdir -p ~/skills-drafts && cd ~/skills-drafts
npx skills init skills-housekeeping

Это создаёт skills-housekeeping/SKILL.md из шаблона. Замените его содержимое на это:

---
name: skills-housekeeping
description: Проверяет установленные навыки агентов на обновления и проблемы с помощью CLI npx skills и объясняет результаты понятным языком. Используйте, когда спрашивают, актуальны ли навыки, когда нужно обновить навыки или когда установленный навык, похоже, отсутствует.
metadata:
  author: graham-miranda
  version: "1.0"
---

# Порядок в навыках

## Правила
- Никогда не запускайте команды с sudo.
- Никогда не запускайте `npx skills update` или `npx skills remove`, не спросив предварительно.
- Запускайте команды из /tmp или из папки проекта, никогда из домашней папки.

## Проверка
1. Запустите `cd /tmp && npx skills@latest check -g` для глобальных навыков.
2. Если в текущем проекте есть файл skills-lock.json, запустите также `npx skills@latest check -p` в папке проекта.
3. Считайте каждую строку, начинающуюся с ✗, как "не проверено", даже если следующая строка говорит, что всё актуально.

## Отчёт
- Перечислите навыки с обновлениями, навыки с локальными изменениями и всё, что не удалось проверить.
- Если какая-либо проверка не удалась, предложите `gh auth login` или GITHUB_TOKEN с доступом только на чтение к публичным репозиториям.
- Спросите перед обновлением. Затем запустите `npx skills update -g` (или `-p`) и сообщите, что изменилось.

Шаг 2 — проверьте его на соответствие стандарту

  • Имя: skills-housekeeping использует только строчные буквы и дефисы, короче 64 символов и совпадает с именем папки. Все три условия обязательны.
  • Описание: в нём сказано что что делает навык и когда когда его использовать, и оно содержит слова, которые люди действительно вводят (“актуально”, “обновить навыки”, “отсутствует”). Описание — единственная часть, которую агент видит перед решением, поэтому оно делает большую часть работы. Стандарт допускает до 1 024 символов; стремитесь к одному-двум предложениям.
  • Длина: намного меньше рекомендованных 500 строк. Когда навык разрастается, переносите детали в references/ и ссылайтесь на него из инструкций.

Проект Agent Skills публикует эталонный валидатор, skills-ref, который проверяет front matter и правила именования: skills-ref validate ./skills-housekeeping.

Шаг 3 — установите его сразу для всех агентов

CLI skills устанавливает и из локальной папки:

npx skills add ./skills-housekeeping -g -a opencode -a claude-code -a codex

Так настоящая копия оказывается в ~/.agents/skills/skills-housekeeping (её напрямую читают OpenCode и Codex) и добавляет ссылку в ~/.claude/skills для Claude Code.

Шаг 4 — Проверка

Спросите простыми словами: “Мои навыки актуальны?” Навык с хорошим описанием подхватывается автоматически. Если этого не происходит, вызовите его по имени, чтобы исключить проблему загрузки: @skills-housekeeping в OpenCode, /skills-housekeeping в Claude Code, $skills-housekeeping в Codex. Если он загружается по имени, но никогда сам по себе, проблема в описании: добавьте фразы, которые вы действительно используете.

Шаг 5 — Поделитесь им

Отправьте папку в репозиторий GitHub, лучше всего внутри skills/ папки (skills/skills-housekeeping/SKILL.md). После этого любой сможет установить его с помощью npx skills add your-name/your-repo. CLI ищет навыки в skills/ и в обычных папках агентов, до трёх уровней вглубь.

Дополнительные поля для отдельных агентов и когда их избегать

Некоторые агенты понимают дополнительные поля front matter. В Claude Code есть disable-model-invocation (только вы можете запустить навык) и context: fork (выполнять его в субагенте); в Cursor есть paths (только для совпадающих файлов); OpenCode может скрыть навык от модели с помощью metadata значение opencode/autoinvoke: false. Они полезны, но переносятся именно стандартные поля. Документация Claude Code отмечает, что вне Claude Code — при загрузке в claude.ai или через Skills API — принимаются только стандартные поля, а всё остальное даёт ошибку. Для навыков, которыми вы делитесь, ограничьтесь назвать, описание, license, compatibility, metadata и экспериментальным allowed-tools.

Устройство навыка агента: front matter из SKILL.md читается при запуске и занимает около 100 токенов, инструкции читаются когда задача совпадает, а справочники, скрипты и ресурсы — только при необходимости
Три слоя: этикетка, рецепт и приложение. Всегда загружается только первый, поэтому хорошие описания важнее длинных инструкций.

Часть 11 — Безопасность: навыки и серверы — это программы

Навык легко принять за “просто файл Markdown”. На самом деле это не так. Это инструкции, которым ваш агент будет следовать с вашими правами, часто со скриптами, которые он запустит на вашей машине. А локальный MCP-сервер — это программа, работающая от вашего имени.

Цифры этого года отрезвляют. Исследование ToxicSkills от Snyk, опубликованное в феврале 2026 года, проверило 3 984 публичных навыка для агентов: у 36,82% была хотя бы одна уязвимость, у 13,4% — критическая, а 76 содержали подтверждённые вредоносные нагрузки. Основные проблемы сосредоточились на ClawHub — общественном маркетплейсе для OpenClaw, где более ранний аудит 2 857 навыков, также описанный Snyk, нашёл 341 вредоносный, около 12% реестра на тот момент. Для сравнения, 100 самых популярных навыков на skills.sh не вызвали ни одной проверки Snyk на промпт-инъекции или вредоносный код. Популярность — не доказательство, но она помогает.

У MCP есть собственная версия этого риска. Документация Claude Code предупреждает, что серверы, которые загружают внешний контент, могут подвергнуть вас промпт-инъекция: веб-страница, комментарий в трекере или отчёт о сбое, содержащий текст, адресованный вашему агенту, а не вам.

Десять привычек, которые обеспечивают безопасность

  1. Прочитайте перед установкой. Используйте npx skills add owner/repo --list, gh skill preview, или просто откройте SKILL.md и его скрипты на GitHub.
  2. Отдавайте предпочтение производителям и известным авторам. Навыки Expo для Expo, Vercel — для Next.js, официальный MCP-сервер вендора для его собственного сервиса.
  3. Проверяйте аудиты. Каждый навык на skills.sh показывает результаты трёх сканеров: Gen Agent Trust Hub, Socket и Snyk. “Pending” означает, что его ещё никто не проверял.
  4. Закрепляйте всё важное. npx skills add owner/[email protected], или gh skill install … --pin v1.2.3, так что обновления происходят тогда, когда выберете вы.
  5. Проверяйте обновления как код. npx skills check, затем прочитайте изменения на GitHub, затем npx skills update.
  6. Фильтруйте сторонние навыки. В OpenCode правила используют навык действие, и побеждает последнее совпадение:

jsonc "permissions": [ { "action": "skill", "resource": "*", "effect": "ask" }, { "action": "skill", "resource": "skills-housekeeping", "effect": "allow" }, { "action": "playwright_*", "resource": "*", "effect": "ask" } ]

Hermes Agent проверяет каждую установку из хаба, и --force не может отменить вердикт “опасно”. Gemini CLI спрашивает ваше согласие перед активацией навыка. 7. Давайте серверам минимальный доступ, которого достаточно. Токены только для чтения с точными правами; отдельные токены для каждого сервера; инструменты записи и удаления — в режиме “ask” или отфильтрованы. 8. Держите секреты вне навыков и закоммиченного конфига. Используйте переменные окружения ({env:NAME} в OpenCode, ${VAR} в конфиге Claude Code .mcp.json, ${env:NAME} в Cursor), а не вставленные вручную ключи. 9. Будьте осторожны с настройками проектов других людей. Клонированный репозиторий может принести свои .mcp.json или навыки. Claude Code спрашивает перед использованием серверов проекта, Gemini CLI держит локальные серверы отключёнными в недоверенных папках, а Hermes Agent загружает навыки проекта только после hermes skills trust. Не проскакивайте эти запросы на автопилоте. 10. Удаляйте то, чем не пользуетесь. Каждый неиспользуемый навык и сервер — это поверхность атаки, за которую вы платите контекстом.

Чек-лист по безопасности навыков агентов и MCP: данные Snyk ToxicSkills по 3 984 публичным навыкам и десять безопасных привычек — от чтения перед установкой и фиксации версий до токенов с минимальными правами
Навык — это инструкции, которые ваш агент выполняет с вашими правами. Устанавливайте его с той же осторожностью, что и любое другое программное обеспечение.

Часть 12 — Еженедельная рутина на две минуты

Навыки и серверы устаревают. Небольшая регулярная проверка держит их в форме:

# Глобальные навыки, из нейтральной папки
cd /tmp && npx skills@latest check -g

# Каждый проект, над которым вы активно работаете
cd ~/code/my-app && npx skills@latest check -p

# После чтения того, что изменилось в upstream:
npx skills update -g

Раз в месяц уделите ещё пять минут:

  • Прореживайте. npx skills ls -g и удаляйте то, чем не пользовались. В Claude Code панель плагинов показывает плагины, которые вы недавно не использовали.
  • Перечислите свои серверы. opencode mcp list, claude mcp list, gemini mcp list или hermes mcp test для каждого. Удалите всё, что вы добавили и забыли.
  • Ротация токенов которые вы выдали серверам, особенно тем, что умеют записывать.

Две машины, одна настройка

Я запускаю агентов на Mac и на Raspberry Pi, и три привычки держат их в согласии:

  1. Один и тот же подход на обеих: под вашим обычным пользователем, никогда sudo, а CLI запускается из папки проекта или /tmp.
  2. Проектные навыки переносятся вместе с Git. Коммит .agents/skills и skills-lock.json; на другой машине npx skills install восстанавливает ровно те же версии.
  3. Глобальные навыки берутся из скрипта. Держите npx skills add … -g команды в небольшом shell-файле и запускаете его на каждой машине. Заодно это документация того, на что вы опираетесь.

На машине без графического интерфейса как на Pi, задайте GITHUB_TOKEN в ~/.bashrc чтобы проверки обновлений не упирались в лимит анонимных запросов. Со входом через браузер нужна осторожность: OpenCode позволяет вставить callback URL в свой промпт, Hermes Agent предлагает вставку ответа обратно, проброс SSH-порта или device flow, а для OAuth в Gemini CLI нужен браузер на той же машине.


Часть 13 — Какую конфигурацию выбрать? Пять сценариев

1. “Я только начал работать с OpenCode.”

Установите не больше трёх навыков и один MCP-сервер. Context7 — хороший первый сервер, а навык для релизов или ревью, подходящий вашему рабочему процессу, — хороший первый навык. Держите сторонние навыки на «спрашивать» в разрешениях OpenCode, пока не начнёте им доверять. Мой руководство по OpenCode рассказывает об остальной части настройки.

2. “Я использую OpenCode и Claude Code вместе, может быть, ещё Hermes Agent.”

Установите навыки глобально через CLI и перечислите каждого агента: npx skills add owner/repo -g -a opencode -a claude-code -a hermes-agent. Одна копия, три агента. У MCP-серверов нет общего файла конфигурации, поэтому добавляйте каждый сервер в каждого агента и храните список там, где вы его найдёте. Моё сравнение OpenCode, Hermes Agent и OpenClaw объясняет, в чём силён каждый агент, а моё сравнение harness для ИИ-кодинга охватывает 28 из них в одном сравнении.

3. “У моей команды общий репозиторий.”

Используйте уровень проекта: закоммитьте .agents/skills, skills-lock.json, и настройки MCP (opencode.jsonc, .mcp.json или .cursor/mcp.json) без секретов в них. Каждый хранит ключи в своём окружении. В CI, npx skills install --frozen-lockfile завершается ошибкой, если у кого-то навыки разошлись, и npx skills check -p завершается ошибкой, когда ждут обновления.

4. “Мои агенты работают на Raspberry Pi или на сервере.”

Один обычный пользователь, никакого sudo, никогда. Задайте GITHUB_TOKEN, предпочитайте удалённые серверы, которые принимают токен в заголовке (или предлагают вход через код устройства), и запускайте еженедельную проверку из /tmp. Часть 6 — ваш контрольный список.

5. “Мой код не должен покидать мою машину.”

Используйте только локальные MCP-серверы, а удалённые серверы документации и поиска по коду пропустите. Отключите телеметрию CLI (DISABLE_TELEMETRY=1), читайте каждый навык, который устанавливаете, и помните, что сама модель может оставаться облачной: конфиденциальность зависит и от того, где модель выполняется модель. Моё руководство по запуску LLM на MacBook рассказывает, сколько на самом деле стоит полностью локальный вариант.


Часто задаваемые вопросы

Что такое навыки агентов?

Навыки агента — это папки, которые учат ИИ-агента выполнять конкретную работу. Каждая из них содержит SKILL.md файл с именем, описанием и пошаговыми инструкциями, а также необязательные скрипты и справочные файлы. В начале сеанса агент читает только описания и загружает полные инструкции навыка, когда задача совпадает. Навыки следуют открытому стандарту, поэтому большинство из них одинаково работает в OpenCode, Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot и Hermes Agent.

Что такое сервер MCP?

MCP-сервер — это небольшая программа, которая даёт ИИ-агенту новые инструменты через Model Context Protocol, открытый стандарт, который сейчас поддерживает Agentic AI Foundation при Linux Foundation. Локальные серверы работают на вашем компьютере и запускаются агентом; удалённые серверы работают на компьютерах провайдера, и к ним обращаются по веб-адресу, обычно с входом через браузер. Примеры — официальный сервер GitHub, Context7 для актуальной документации и Playwright для управления браузером.

В чём разница между навыками агента и MCP-серверами?

Навык даёт агенту знания: письменные инструкции о том, как выполнить работу, которые загружаются только при необходимости. MCP-сервер даёт агенту возможности: инструменты, которые достают до систем за пределами терминала, например GitHub, браузера или трекера сбоев. Используйте навык для процедур и соглашений, MCP-сервер — для живого доступа к системе, а AGENTS.md для правил, которые действуют в любой задаче. Если есть хороший инструмент командной строки, навык, который учит агента работать с ним, часто дешевле сервера.

Работают ли навыки одинаково в OpenCode, Claude Code и Codex?

В основном потому, что все три следуют стандарту Agent Skills. Разница в том, куда они смотрят. Codex и OpenCode читают общие .agents/skills и ~/.agents/skills папки; OpenCode также читает .opencode/skills и папки Claude Code. Claude Code читает только .claude/skills и ~/.claude/skills. Некоторые дополнительные поля front matter, например context: fork, работают только в одном агенте, поэтому общие навыки должны придерживаться стандартных полей.

Как установить навык с помощью npx skills?

Запуск npx skills add owner/repo --list чтобы посмотреть, какие навыки предлагает репозиторий, затем npx skills add owner/repo --skill skill-name -a opencode -a claude-code чтобы установить нужный для агентов, которыми вы пользуетесь. Добавьте -g чтобы сделать его доступным в каждом проекте. Нужен Node.js 22.20 или новее. Без флагов CLI спрашивает, какие навыки и каких агентов вы хотите и связать файлы или скопировать их.

Куда npx skills устанавливает навыки?

При установке в проект настоящая копия попадает в .agents/skills/<name> внутри вашего проекта и записывается в skills-lock.json. Глобальные установки (-g) помещают его в ~/.agents/skills/<name> и записывают в ~/.agents/.skill-lock.json. Агенты, которые читают .agents/skills используют эту копию напрямую; для агентов с собственной папкой, таких как Claude Code (.claude/skills) или Hermes Agent (~/.hermes/skills), CLI создаёт ссылку на неё.

Как узнать, актуальны ли мои навыки?

Запуск npx skills@latest check -g для глобальных навыков или npx skills@latest check -p внутри проекта. CLI сравнивает отпечаток каждой папки навыка в вашем lock-файле с той же папкой в upstream и перечисляет навыки, у которых есть обновление, ничего не устанавливая. Начиная с версии 1.7.5 (2 ноября 2026), check только сообщает; npx skills update устанавливает. Запускайте её из папки проекта или /tmp, а не из домашней папки.

Почему npx skills сообщает, что все навыки актуальны, если проверка не удалась?

Потому что в сводке учитываются только найденные обновления. Если лимит GitHub в 60 анонимных запросов к API в час блокирует каждую проверку, CLI печатает строку ✗ для каждого источника и всё равно может завершиться сообщением “Все глобальные навыки обновлены”. Войдите с помощью gh auth login или задайте доступный только для чтения GITHUB_TOKEN чтобы поднять лимит до 5 000 запросов в час, обновитесь с помощью npx skills@latest, и всегда читайте строки с ✗.

Стоит ли использовать sudo с npx skills?

Нет. Навыки хранятся отдельно для каждого пользователя, а у root своя домашняя папка, поэтому sudo устанавливает навыки в /root/.agents/skills, куда агенты, запущенные от вашего обычного пользователя, никогда не заглянут. Он также может оставить файлы, принадлежащие root, в ваших собственных папках и вызвать ошибки npm вроде “prefix cannot be changed from project config”. Запускайте CLI и своих агентов от обычного пользователя.

Как добавить сервер MCP в OpenCode?

Запуск opencode mcp add <name> --url <address> для удалённого сервера или opencode mcp add <name> -- <command> для локального, а затем проверьте его с помощью opencode mcp list. Добавьте --global чтобы использовать его в каждом проекте. Те же настройки могут находиться в mcp.servers в opencode.jsonc, где секреты записываются как {env:NAME}. Используйте opencode mcp auth <name> чтобы войти, а /mcps внутри сеанса, чтобы подключать или отключать серверы.

Сколько серверов MCP стоит установить?

Как можно меньше — только те, что вы действительно используете, обычно от двух до пяти. Инструменты каждого сервера идут с описаниями, которые модель должна прочитать; это расходует контекст и может сделать ответы медленнее и менее сфокусированными. Claude Code откладывает определения инструментов до момента, когда они понадобятся, а OpenCode группирует их по серверам, и это помогает, но неиспользуемые серверы всё равно добавляют риск и беспорядок. Удаляйте всё, чем не пользовались месяц.

Безопасно ли устанавливать навыки агентов?

Безопасны ровно настолько, насколько надёжен их источник. Навык — это инструкции, которые ваш агент выполняет с вашими правами, часто вместе со скриптами, которые он запускает. Февральское исследование Snyk 2026 года по 3 984 публичным навыкам выявило уязвимости у 36,82% и подтвердило вредоносные полезные нагрузки у 76. Прочитайте навык и его скрипты перед установкой, отдавайте предпочтение навыкам от создателей самого инструмента, проверяйте результаты аудита на skills.sh, фиксируйте версии и держите сторонние навыки в режиме “ask” в разрешениях агента.

Что такое skills-lock.json?

Это файл блокировки проекта, который skills CLI создаёт при установке навыков в проект. Он записывает, откуда взялся каждый навык, и отпечаток его файлов. Добавьте его в Git: на другом компьютере npx skills install восстанавливает ровно те же навыки, а --frozen-lockfile завершится ошибкой, если что-то отличается. У глобальных навыков отдельный файл блокировки в ~/.agents/.skill-lock.json, по одному на учётную запись пользователя.

Что такое skills.sh?

skills.sh — публичный каталог навыков для агентов от Vercel. Он ранжирует навыки по числу установок, группирует их по темам и показывает для каждого результаты проверки безопасности от Gen Agent Trust Hub, Socket и Snyk. Навыки оттуда устанавливаются с помощью npx skills add owner/repo команды, которую он показывает. Команда того же CLI npx skills find ищет по каталогу из вашего терминала.

Итог

Навыки агентов и серверы MCP отвечают на два разных вопроса. Навыки отвечают на “как мы это делаем здесь?”: это дешёвые переносимые карточки с рецептами, которые загружаются только при необходимости. MCP-серверы отвечают на “можете ли вы добраться до этой системы?”: это мощные ключи, которые стоят контекста и требуют такого же внимания, как любое программное обеспечение, которое вы устанавливаете. AGENTS.md содержит те немногие правила, которые применимы ко всему, а разрешения обеспечивают соблюдение того, что не должно происходить никогда.

Если вы возьмёте из этого руководства пять вещей, пусть это будут:

  1. Поместите общие навыки в .agents/skills и дайте npx skills связать их с агентами, которые ищут в другом месте.
  2. Запуск npx skills@latest check из папки проекта или /tmp, читайте строки с ✗ и обновляйтесь осознанно.
  3. Войдите в GitHub (gh auth login) на каждой машине, которая проверяет обновления.
  4. Никогда не используйте sudo с навыками или агентами.
  5. Начните с трёх навыков и одного сервера, и добавляйте новые только тогда, когда их потребует реальная задача.

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


Пользуетесь навыками или MCP-серверами, о которых я не упомянул? Мне интересно узнать, какие из них заняли постоянное место в вашей настройке, а какие сообщения об ошибках заставили вас искать решение. Исправления приветствуются: статья обновляется, когда меняются инструменты, а судя по этому году, это будет часто.

Раскрытие информации: Ни одна компания, упомянутая в этой статье, не спонсировала, не рецензировала и не одобряла её, и в ней нет партнёрских ссылок. Продукты названы только в тексте; на изображениях мои собственные логотипы.

Последнее обновление: 15 ноября 2026.

Добавьте свой сигнал.

Ваш адрес email не будет опубликован. Обязательные поля помечены *

ru_RUРусский