Вся документация

Пакеты

Пакет — это готовый набор: несколько скиллов, команд, субагентов и MCP-серверов, собранных вместе. В таком виде обычно распространяются коллекции — например, «всё для продакт-менеджера» или плагины Claude. onplate понимает пакеты, плагины и целые маркетплейсы плагинов — и ставит их в любой поддерживаемый AI.

Пакеты живут в Хранилище скиллов — переключите фильтр Тип на «Пакеты» или найдите их в группе «Пакеты».

Как пакет попадает в хранилище

Отдельной кнопки «Импортировать пакет» больше нет. Всё добавляется одним входом — кнопкой Добавить в хранилище, а вид записи onplate определяет сам:

Папка с манифестом едет в «Пакеты» целиком, вместе со своими командами и hooks. Отдельный SKILL.md становится скиллом.

Так что «добавить пакет» — это выбрать папку с манифестом, плагином или маркетплейсом, либо подключить Git-репозиторий.

При подключении репозитория импорт идёт по стадиям с индикатором:

  1. Клонирование репозитория — скачивание;
  2. Разбор и добавление пакетов — onplate находит все пакеты внутри;
  3. Докачка внешних плагинов — если маркетплейс ссылается на плагины в других репозиториях, они подтянутся тоже.

Репозиторий добавляется в раздел Репозитории и дальше отслеживается: когда автор выпустит обновление, вы увидите это на Дашборде.

Карточка пакета

Строка пакета разворачивается в состав пакета — дерево файлов по видам: команды, скиллы, субагенты, MCP-серверы, hooks и rules. У каждой записи — оценка сканера.

Кроме состава видно:

  • сводку безопасности — «N безопасных · N подозрительных · N опасных» по всем ресурсам пакета, с кнопкой Показать, почему такая оценка;
  • откуда пакет пришёл — папка, репозиторий или маркетплейс;
  • как пакет установлен — пометка «плагином: …» перечисляет AI, где пакет зарегистрирован нативным плагином. Один и тот же пакет может стоять плагином в одном AI и обычной раскладкой в другом, поэтому пометка перечисляет цели, а не просто говорит «да/нет»;
  • plugin-контейнер — если внутри есть такая запись, она помечается «только для просмотра»: сама по себе она не устанавливается, а поддерживаемые вложенные ресурсы ставятся отдельно.

Добавить пакет в AI

Кнопка Добавить открывает диалог установки:

  1. Состав — что именно будет установлено. Ресурсы, которые не подходят выбранным целям, помечаются «не встанет для выбранных целей» — сюрпризов не будет.
  2. Как устанавливать — россыпью по каталогам AI или нативным плагином (см. ниже).
  3. Цели — в какие AI ставить, можно несколько сразу.
  4. Область — Глобально или В проект с выбором папки.
  5. Безопасность — сводка по ресурсам. Если в пакете есть опасный ресурс, потребуется обоснование. Отдельное предупреждение выводится, если пакет добавляет hooks — команды, выполняемые автоматически.

После установки Орби покажет итог: сколько копий ресурсов удалось подтвердить, сколько записей выполнено и что пропущено из-за несовместимости. Запись файла сама по себе ещё не считается подтверждённой установкой: onplate перечитывает локальное состояние и сверяет результат.

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

Россыпью или нативным плагином

У Claude Code и Codex есть собственный реестр плагинов, и пакет можно поставить туда целиком. Переключатель «Как устанавливать» предлагает два режима:

  • Россыпью по каталогам AI — по умолчанию: скиллы, команды и субагенты ложатся в каталоги AI по отдельности. Работает во всех целях.
  • Нативным плагином, где AI умеет — пакет регистрируется в реестре плагинов самого AI. Он появляется в списке плагинов (claude plugin list, codex plugin list), его можно выключить целиком, а скиллы отдаются модели с неймспейсом вида pm-toolkit:privacy-policy — команды двух разных маркетплейсов больше не затирают друг друга по имени.

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

Отдельная подсказка появляется, если выбраны сразу claude и opencode: OpenCode по умолчанию читает и каталоги скиллов Claude и дедуплицирует их по имени, поэтому вторая копия скилла записывается, но использована не будет. Копия всё же пишется — она станет единственной рабочей, если внешние источники у OpenCode отключены переменными OPENCODE_DISABLE_EXTERNAL_SKILLS или OPENCODE_DISABLE_CLAUDE_CODE_SKILLS.

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

Экспорт в чужой формат

Пакет можно собрать так, чтобы он работал без onplate на той стороне: Экспорт в чужой формат → «Собрать как плагин Claude», «как плагин Codex» или «как плагин Cursor».

Это не установка: ничего не подключается и не меняется в ваших AI. onplate складывает файлы в выбранную папку — её можно отправить коллеге или положить в репозиторий. До сборки видно, что войдёт и что не войдёт: например, MCP-серверы не переносятся в формат Codex, потому что там они задаются идентификатором коннектора, а не командой запуска. В формат Cursor не переносятся hooks: его схема у onplate не снята замером с живого клиента, а положить туда чужую схему — значит отдать заведомо нерабочий файл под видом рабочего.

Обновление и откат

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

Все операции с пакетами записываются в Журнал.

Удаление

  • Удалить (установку) — снять пакет со всех AI и с диска; запись в хранилище остаётся.
  • Удалить из хранилища — пакет уходит в корзину: он снимается с диска, но его можно восстановить.

Восстановление возвращает пакет, его ресурсы, файлы и снимки в хранилище, но не разворачивает снятые установки заново. После восстановления выберите нужные AI и установите пакет повторно.