Раздача артефактов

Скилл, который работает только у вас, — это заметка. Скилл, который коллега получает без ручной настройки, — это инструмент. Между ними три способа доставки, и они не равнозначны.

Три способа

Практический маршрут: начинайте со standalone-каталога .claude/, пока итерации быстрые, и превращайте в плагин, когда пора делиться.

Что такое плагин

Плагин — самодостаточный каталог. Манифест лежит в .claude-plugin/plugin.json, всё остальное — в корне плагина. Это место ошибки номер один: skills/, agents/, hooks/ внутри .claude-plugin/ не читаются.

my-plugin/
├── .claude-plugin/
│   └── plugin.json      имя, описание, версия, автор
├── skills/<имя>/SKILL.md
├── agents/              описания субагентов
├── hooks/hooks.json     обработчики событий
├── .mcp.json            MCP-серверы
├── .lsp.json            языковые серверы
├── monitors/monitors.json  фоновые наблюдатели
├── bin/                 исполняемые файлы, добавляемые в PATH
└── settings.json        значения по умолчанию (ключи agent, subagentStatusLine)

Поле name из манифеста становится пространством имён: каталог hello/ в плагине my-first-plugin даёт команду /my-first-plugin:hello. Поле version управляет обновлениями — пользователи получат новое, когда вы поднимете номер.

Разработка и проверка

claude --plugin-dir ./my-plugin        # загрузить локально, без установки
claude --plugin-dir ./my-plugin.zip    # архив тоже принимается
claude plugin validate ./my-plugin     # проверить структуру и frontmatter

Флаг можно повторять для нескольких плагинов. Локальная копия перебивает установленную из маркетплейса с тем же именем — удобно тестировать правку, не удаляя рабочую версию. После изменений выполняйте /reload-plugins: он перезагружает скиллы, агентов, хуки, MCP- и LSP-серверы плагина без перезапуска сессии.

Отдельный лёгкий путь: claude plugin init my-tool создаёт ~/.claude/skills/my-tool/ с манифестом и заготовкой SKILL.md. Такой каталог со следующей сессии грузится как плагин my-tool@skills-dir — без маркетплейса и установки.

Миграция того, что уже есть

Перенос standalone-конфигурации в плагин механический: скопировать commands/, agents/, skills/ в корень плагина, а блок hooks из settings.json — в hooks/hooks.json (формат тот же). После переноса уберите оригиналы: проектные и пользовательские определения агентов перебивают одноимённые плагинные, поэтому плагинная версия иначе просто не заработает. Со скиллами не так: плагинные namespaced, и обе версии останутся доступны.

Маркетплейсы

Официальный маркетплейс claude-plugins-official регистрируется сам при первом интерактивном запуске. Общественный добавляется вручную:

claude plugin marketplace add anthropics/claude-plugins-community

Для команды маркетплейс — это просто репозиторий с манифестом marketplace.json, и он может быть приватным. Это и есть рабочий способ раздать набор внутри организации: люди подключают маркетплейс один раз, дальше /plugin показывает ваши плагины.

Границы, которые ставит организация

Администратор может ограничить источники: strictKnownMarketplaces разрешает только известные маркетплейсы, blockedMarketplaces запрещает конкретные, disableSideloadFlags отклоняет флаги, подгружающие плагины и агентов на один прогон, а strictPluginOnlyCustomization вообще запрещает скиллы, агентов, хуки и MCP-серверы из пользовательских и проектных источников — только из плагинов и управляемых настроек. Подробности — Развёртывание на гильдию.

Если ваш скилл несёт хуки или MCP-сервер, помните, что оба механизма приезжают вместе с плагином и начинают работать у получателя: Стражи и Врата протокола. Это ответственность автора, а не пользователя.

Перед раздачей проверьте устройство самого артефакта — Устройство артефакта.