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

Хранилище скиллов

Хранилище — это ваша библиотека. Здесь лежат все скиллы и пакеты, которые вы добавили в onplate. Важно понимать разницу:

  • В хранилище — скилл сохранён в onplate вместе с историей версий, но AI о нём ещё не знает.
  • Установлен — скилл из хранилища скопирован в папку конкретного AI-инструмента, и тот начал им пользоваться.

Один скилл из хранилища можно установить в несколько AI сразу — в этом и смысл.

Поиск и фильтры

Сверху — строка поиска: ищет по названиям скиллов и пакетов, автору и тегам. Рядом фильтры:

  • Тип — показать всё, только скиллы или только пакеты;
  • фильтр по AI — только то, что установлено в выбранный инструмент;
  • теги и избранное — см. ниже.

Добавить скилл

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

Вкладка «Создать»

Новый скилл с нуля: заполните имя (латиницей, например report-helper), заголовок, описание и инструкции — текст, который будет читать AI. Русское имя onplate транслитерирует автоматически. Дальше скилл можно развивать в Редакторе.

Вкладка «Импорт»

Скилл откуда-то ещё:

  • Вставить содержимое — текст из буфера обмена (формат SKILL.md, JSON- или YAML-манифест);
  • Файл / папка — перетащите папку или файл (.md, .json, .yaml, .zip) прямо в окно, или выберите вручную;
  • URL — ссылка на файл в интернете, например raw-ссылка GitHub.

Каждый импортируемый скилл автоматически проходит проверку безопасности. Если найдены опасные конструкции, onplate подсветит их и потребует комментарий-обоснование — почему вы доверяете этому скиллу. Без обоснования опасный скилл не импортируется.

Карточка скилла

Клик по скиллу раскрывает карточку:

  • Автор, версия, совместимость — с какими AI скилл может работать;
  • Статус безопасности — Безопасно / Подозрительно / Опасно, со ссылкой «показать найденные угрозы»;
  • Показать содержимое — полный текст скилла, не выходя из списка;
  • Редактировать — переход в Редактор;
  • Профиль качества — иконка-датчик в строке карточки разворачивает оценку качества (см. ниже);
  • Источник — откуда скилл пришёл; кнопка Проверить источник сравнит вашу копию с оригиналом и скажет, «совпадает с источником» или «источник изменился».

Установка в AI

В карточке нажмите Установить, выберите AI и область:

  • Глобально — работает во всех проектах;
  • В проект — только в выбранной папке (укажите её кнопкой выбора).

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

Когда в хранилище появляется новая версия, у установок появляется пометка «устар.» и кнопка Обновить — свежая версия развернётся поверх старой. Все установки видны в разделе Привязки.

Как понять, что установка завершилась

После установки, смены версии, удаления или восстановления откройте Орби. В блоке «Последнее подтверждённое действие» он показывает фактический результат: AI, область, версию и путь установленного файла.

  • «Скилл установлен» означает, что onplate перечитал локальные привязки и нашёл ожидаемую копию.
  • «Не удалось подтвердить…» не означает, что ничего не изменилось. Операция могла остановиться после части записей, поэтому итоговое состояние неизвестно.

Если результат не подтверждён, сначала обновите Хранилище скиллов и Привязки. Проверьте, какая версия и какой путь видны сейчас, и только потом повторяйте действие. Техническая причина ошибки показывается на текущем экране, но Орби не сохраняет её в своей истории.

Теги и избранное

Наводите порядок в большой библиотеке:

  • Теги — свободные метки («работа», «тексты», «python»). Добавляются в карточке; можно размечать сразу несколько скиллов. По тегам работает поиск и фильтр.
  • Избранное — звёздочка на самых нужных скиллах, отдельный фильтр показывает только их.

Теги и избранное хранятся только на вашем компьютере.

Профиль качества

Иконка-датчик в строке карточки разворачивает оценку скилла по шести измерениям: безопасность, структура, документация, сопровождаемость, доверие, переносимость — с общим баллом и объяснением каждой оценки. Профиль также определяет язык и тип скилла (Backend, Тестирование, Документация и т.д.). Это помогает быстро отличить аккуратный скилл от собранного на коленке.

Экспорт

Любой скилл можно выгрузить в универсальном формате (USF): кнопка Экспорт → предпросмотр → Сохранить в файл или Копировать. Удобно, чтобы поделиться скиллом с коллегой — тот импортирует файл у себя.

Удаление и корзина

Два варианта удаления, чтобы ничего не потерять случайно:

  • Удалить из хранилища — скилл уходит в корзину onplate. Версии сохраняются, скилл можно Восстановить. Файлы, уже установленные в AI, остаются на диске и продолжают работать.
  • Удалить из хранилища и с диска — снимаются все установки во всех AI, и запись уходит в корзину.

Корзина — отдельный раздел в боковом меню, сразу под хранилищем. В неё попадают удалённые скиллы, пакеты, субагенты и отдельные версии; счётчик рядом с пунктом меню показывает, сколько там всего лежит. В самой корзине видно, когда запись удалена, и что с ней можно сделать: Восстановить, стереть навсегда или очистить корзину целиком. Стирание навсегда необратимо — onplate предупредит.

Важно: восстановление возвращает запись и версии в хранилище, но не создаёт заново установки, которые были сняты с диска. После восстановления установите скилл в нужные AI повторно.