Плагин и скиллы

Плагин «Пачка» ставит сразу подключение к MCP-серверу, скиллы и команды. Плагин работает в Claude Code, приложении Claude, Codex, VS Code с GitHub Copilot и Cursor, а в остальные агенты скиллы ставятся без него:

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

Скиллы — знание о том, как правильно делать задачи в Пачке: куда писать и что подтверждать, как найти и пересказать обсуждение, какой токен выбрать и почему не хватает прав. Справочник по аргументам агент берёт из описаний инструментов MCP-сервера, pachca <команда> --help и страниц методов, поэтому скиллы его не повторяют и ссылаются на документацию. Скиллы работают с любым способом подключения: MCP-сервером, CLI или API.

Claude Code

claude plugin marketplace add pachca/openapi --sparse .claude-plugin pluginsclaude plugin install pachca@pachca

Флаг --sparse скачивает из репозитория только папки .claude-plugin и plugins. Внутри сессии то же делают команды /plugin marketplace add pachca/openapi и /plugin install pachca@pachca. Плагин, установленный из терминала, загрузится в следующей сессии, а в открытой сессии выполните /reload-plugins.

В расширении Claude Code для VS Code введите /plugins, добавьте pachca/openapi на вкладке Marketplaces и нажмите Install у плагина на вкладке Plugins. В приложении Claude на вкладке Code нажмите + у поля ввода и выберите Add plugins: плагин появится в списке, если маркетплейс уже добавлен из терминала или VS Code. Терминал, VS Code и вкладка Code на одном компьютере читают одни настройки, поэтому плагин достаточно поставить один раз.

Только скиллы, без MCP-сервера, ставит команда из раздела Скиллы без плагина с агентом claude-code. В облачных сессиях Claude Code плагин не загружается. Пачка доступна там через коннектор, подключённый в приложении Claude.

Вход в Пачку

Выполните /mcp, выберите сервер Пачки из плагина и войдите через браузер. В командах claude mcp сервер плагина называется plugin:pachca:pachca. Как войти из терминала и по SSH — в разделе Claude Code, что видно на экране согласия — в разделе Вход через браузер.

Если сервер уже добавлен вручную

Сервер плагина не подключается, если сервер с тем же адресом уже добавлен командой claude mcp add или в .mcp.json. Claude Code работает через сервер, добавленный вручную, поэтому инструменты не задваиваются. Чтобы перейти на сервер плагина, удалите ручной:

claude mcp remove pachca

Сервер с заголовком Authorization тоже заменяет сервер плагина, даже если переменная с токеном не задана. Тогда Пачка не подключится, а войти через браузер Claude Code не предложит. Держите такой сервер только там, где входить некому, например в CI, и передавайте его отдельным файлом, как в разделе Claude Code без браузера.

Обновления

Новая версия плагина выходит, когда меняются его файлы. Поставить её можно командой:

claude plugin update pachca@pachca

Автообновление маркетплейса pachca по умолчанию выключено. Чтобы его включить, откройте /plugin, на вкладке Marketplaces выберите pachca и нажмите Enable auto-update. Новая версия загрузится в следующей сессии или после /reload-plugins.

Приложение Claude

Плагин работает в приложении Claude на тарифах Pro, Max, Team и Enterprise. Он ставится в аккаунт Claude один раз и доступен в чате на claude.ai, в приложении Claude на компьютере и телефоне и в Cowork. Скиллам нужно выполнение кода: на тарифах Pro и Max включите Code execution and file creation в Settings > Capabilities, на тарифах Team и Enterprise этот переключатель и Skills включает владелец организации Claude. На тарифе Free плагинов нет, там Пачку подключают коннектором.

Скиллы плагина появятся в Customize > Skills и включаются и выключаются вместе с ним. Свежую версию подтягивает кнопка Check for updates у маркетплейса pachca. Чтобы обновления приходили сами, включите у маркетплейса Sync automatically.

В Claude Code 2.1.273 и новее плагин из аккаунта сам появится в терминале, если вы вошли в Claude Code через аккаунт Claude. Если вы входили на более ранней версии, выполните /login ещё раз и перезапустите Claude Code. Если плагин уже установлен командой claude plugin install, Claude Code использует эту копию. В Пачку в Claude Code нужно войти отдельно, как в разделе Вход в Пачку.

Для всей организации

На тарифах Team и Enterprise сотрудники не добавляют коннекторы сами. Сначала владелец организации Claude добавляет сервер Пачки, как в разделе Claude. Затем сотрудники ставят плагин по шагам выше, если владелец не выключил User-created skills в Organization settings > Plugins & skills > Policy.

Чтобы плагин сразу был у всех, владелец создаёт закрытый репозиторий на GitHub с файлом .claude-plugin/marketplace.json, который ссылается на папку плагина в открытом репозитории Пачки, и подключает его в Organization settings > Plugins & skills > Add > Sync from GitHub. Затем на вкладке Inventory выбирает для плагина Default access > Installed by default. Свежую версию подтягивает кнопка Re-sync.

{  "name": "pachca-company",  "owner": { "name": "Ваша компания" },  "plugins": [    {      "name": "pachca",      "source": {        "source": "git-subdir",        "url": "https://github.com/pachca/openapi.git",        "path": "plugins/pachca"      }    }  ]}

Каждый сотрудник подключает Пачку на вкладке Connectors плагина и входит под своей учётной записью.

Codex

Плагин ставит в Codex MCP-сервер, скиллы и команды. Он работает в Codex CLI и в Codex в приложении ChatGPT на компьютере.

codex plugin marketplace add pachca/openapi --sparse .agents/plugins --sparse plugins/pachcacodex plugin add pachca@pachcacodex mcp login pachca

Первая команда добавляет каталог плагинов Пачки, вторая ставит плагин, третья открывает браузер для входа в Пачку. Флаг --sparse скачивает из репозитория только папки каталога и плагина. Это важно: при каждом изменении репозитория Codex скачивает каталог заново, а без флага это был бы весь репозиторий. Скиллы и инструменты Пачки появятся в новой сессии Codex. В Codex CLI плагин можно поставить и из каталога командой /plugins.

Как войти на компьютере без браузера — в разделе Codex. Там, где входить некому, например в CI, подключите сервер персональным токеном под именем pachca: такой сервер заменяет сервер плагина, а скиллы и команды плагина продолжают работать.

При каждом запуске Codex проверяет каталог и сам ставит свежую версию плагина. Обновить его сразу можно командой:

codex plugin marketplace upgrade pachca

Расширение Codex для редактора плагины не ставит. Для него поставьте скиллы без плагина с агентом codex и подключите сервер, как в разделе Codex.

VS Code и GitHub Copilot

Плагин подключает MCP-сервер, скиллы и команды в VS Code с GitHub Copilot и в GitHub Copilot CLI. В чате VS Code в среде Copilot, которая выбрана по умолчанию с версии 1.143, выполните:

/plugin marketplace add pachca/openapi/plugin install pachca@pachca

Из терминала то же делает GitHub Copilot CLI. Установленный так плагин VS Code подхватывает сам:

copilot plugin marketplace add pachca/openapicopilot plugin install pachca@pachca

Если команды /plugin в чате нет, проверьте настройку chat.plugins.enabled: её может выключить администратор организации. Плагином управляют там же, где его поставили: плагин из команды /plugin в панели расширений не виден.

VS Code предложит войти в Пачку через браузер при первом запуске сервера. В Copilot CLI войдите командой /mcp auth pachca. Свежую версию ставит команда ниже, а для плагина, поставленного из чата VS Code, команда /plugin update pachca в чате:

copilot plugin update pachca

Сервер с именем pachca, добавленный вручную, Copilot заменяет сервером плагина, поэтому отдельно его добавлять не нужно. Если скиллы уже поставлены командой npx skills add, Copilot берёт их, а не скиллы плагина. Удалите их, чтобы скиллы обновлялись вместе с плагином.

Cursor

Плагин «Пачка» ставит в Cursor MCP-сервер, скиллы и команды. Сервер плагина в Cursor подключается персональным токеном из переменной окружения PACHCA_TOKEN.

export PACHCA_TOKEN="<токен>"

agent plugin marketplace add https://github.com/pachca/openapi

Если плагин «Пачка» стоит в Claude Code, Cursor подключает его сам, пока включена настройка Include Third-Party Plugins, Skills, and Other Configs в Settings > Agents > Third-Party Imports. Ставить плагин в Cursor ещё раз не нужно, но токен в PACHCA_TOKEN нужен и в этом случае.

В Cursor сервер плагина называется plugin-pachca-pachca. Если переменная PACHCA_TOKEN не задана, он не подключится. Сервер Пачки в mcp.json с плагином не нужен, уберите его.

Без плагина поставьте скиллы командой из раздела Скиллы без плагина с агентом cursor и подключите сервер, как в разделе Cursor.

Скиллы без плагина

В остальные агенты скиллы ставит команда npx skills. Ей нужен Node.js 22.20 или новее.

npx skills add https://dev.pachca.com -g -a opencode -y

• -a задаёт агента: opencode, devin, cline, kilo, qwen-code, gemini-cli, cursor, codex, github-copilot, claude-code и другие. Несколько агентов перечислите через пробел.
• -g ставит скиллы для всех проектов. Без него скиллы попадут в текущий проект, а рядом появится файл skills-lock.json.
• -y ставит без вопросов. Без флагов команда спросит, какие скиллы, для каких агентов и куда поставить.

Если в программе уже стоит плагин «Пачка», скиллы этой командой в неё не ставьте: у агента окажется по две копии каждого скилла. С флагом -g скиллы часто попадают в папки, которые читают сразу несколько программ: ~/.agents/skills/ читают Codex, Cursor и VS Code, а ~/.claude/skills/ читают Claude Code, Cursor, VS Code и OpenCode. Если плагин «Пачка» стоит в одной из этих программ, вторая копия скиллов окажется и в ней. Без -g вторая копия появится так же, только в этом проекте: скиллы попадут в папку проекта .agents/skills/, которую читают Codex, Cursor и VS Code, или .claude/skills/, которую читают Claude Code, Cursor и VS Code. Поэтому для другого агента распакуйте скиллы в папку, которую читает только он, как в разделе Установка вручную, например в ~/.config/opencode/skills/ для OpenCode.

Команды плагина npx skills не ставит, они есть только в плагине. Свежие скиллы ставит команда:

npx skills update

Семи прежних скиллов Пачки больше нет. Если они у вас стоят, удалите их, а новые поставьте командой из начала раздела. Без -g команда удалит скиллы из текущего проекта.

npx skills remove pachca-chats pachca-forms pachca-messages pachca-profile pachca-security pachca-tasks pachca-users -g -y

У SourceCraft Code Assistant своего имени в команде нет. Он читает папки .agents/skills/ проекта и ~/.agents/skills/. В проект скиллы ставит команда:

npx skills add https://dev.pachca.com -a universal -y

Для всех проектов распакуйте скиллы в ~/.agents/skills/, как в разделе Установка вручную. Флаг -g с агентом universal не подходит: так скиллы попадут в папку, которую SourceCraft не читает. В GigaCode CLI скиллы ставятся вручную.

В Devin Desktop ставьте только скиллы, с агентом devin: сервер плагина там не сможет войти в Пачку. MCP-сервер в программах без плагина подключается отдельно: OpenCode, Qwen Code и GigaCode CLI, SourceCraft Code Assistant, Devin Desktop, Cline, Kilo Code, Gemini CLI.

Установка вручную

Скиллы лежат на сайте архивами https://dev.pachca.com/.well-known/agent-skills/<скилл>.tar.gz. В архиве нет общей папки, поэтому каждый скилл распакуйте в папку с его именем: программа сверяет имя папки с именем скилла. Пример для папки ~/.agents/skills/, которую читают Cursor, Codex, GitHub Copilot, OpenCode, Cline, Kilo Code, Gemini CLI, Devin Desktop и SourceCraft Code Assistant:

for s in pachca pachca-messaging pachca-search pachca-admin pachca-bots pachca-ai-agent pachca-oauth pachca-api; do  mkdir -p ~/.agents/skills/$s  curl -fsSL https://dev.pachca.com/.well-known/agent-skills/$s.tar.gz | tar -xz -C ~/.agents/skills/$sdone

Команда написана для macOS и Linux. В Windows распакуйте архивы так же, в папку %USERPROFILE%\.agents\skills\<скилл>\. Для GigaCode CLI замените папку на ~/.gigacode/skills/, для Qwen Code на ~/.qwen/skills/. Чтобы обновить скиллы, выполните команду ещё раз.

Для приложения Claude и Yandex AI Studio те же скиллы лежат архивами ZIP с папкой скилла внутри: https://dev.pachca.com/skills/<скилл>.zip. В приложении Claude такой архив загружают в Customize > Skills > + > Create skill > Upload a skill. Это путь без плагина.

Yandex AI Studio и GigaChat

В Yandex AI Studio скилл загружают ZIP-архивом с папкой скилла внутри:

1. Скачайте архив скилла, например https://dev.pachca.com/skills/pachca-search.zip. Агенту, который ищет и пишет в Пачке, пригодятся pachca-search и pachca-messaging.
2. Откройте Agent Core > Навыки, нажмите Создать навык и перетащите архив в окно.
3. В Agent Atelier > Текстовые агенты выберите агента, в поле Навыки нажмите Добавить, выберите скилл и нажмите Сохранить версию.

Для этого нужна роль ai.canvasAgents.editor. Сервер Пачки агенту подключают отдельно, как в разделе Yandex AI Studio.

GigaChat скиллы сам не загружает, поэтому передайте агенту текст скилла как системную инструкцию. Агенту из раздела Агент на GigaChat, который ищет и пересказывает, подойдёт pachca-search:

curl -fsSL --create-dirs -o skills/pachca-search/SKILL.md https://dev.pachca.com/.well-known/skills/pachca-search/SKILL.md

В agent.py из того раздела прочитайте скилл и передайте его в create_agent:

from pathlib import Path skill = Path("skills/pachca-search/SKILL.md").read_text(encoding="utf-8")agent = create_agent(GigaChat(model="GigaChat-2-Max"), tools, system_prompt=skill)

Файлы из папки references/, на которые ссылается скилл, так агенту недоступны. Если они нужны, скачайте их и добавьте к тексту.

Команды плагина

Команды — готовые задачи, которые вы запускаете сами. Агент берёт команду, только когда вы её вызвали, а в чате приложения Claude команда может сработать и без вызова, когда просьба подходит.

После команды можно указать, что нужно: период, чат или ссылку на тред, например /pachca:catch-up со вчерашнего дня.

Без вашего подтверждения агент ничего не отправляет в чаты и не создаёт задачи для других сотрудников. Дайджест он публикует только в чат, участники которого видят все чаты-источники.

Без плагина команд нет: те же задачи агент решит по обычной просьбе со скиллами pachca-search и pachca-messaging.

Скиллы

Каждый скилл — это файл SKILL.md с короткими правилами и папка references/ с подробностями. Агент читает скилл, когда задача подходит под его описание. Скилл pachca отдаётся и по адресу /skill.md: его можно дать агенту ссылкой, как llms.txt.

Скиллы раздаются по стандарту Agent Skills Discovery: индекс лежит по адресу /.well-known/agent-skills/index.json. Команды плагина в индекс не входят. Исходники — в папке plugins/pachca репозитория.