skill-distribution

Skill Distribution — workflow для упаковки, установки, публикации и передачи Agent Skill, когда нужно решить, как доставить SKILL.md на машину другого пользователя. Его предмет — распространение уже существующего навыка, а не написание его содержания. Источник исходит из простой технической предпосылки: совместимый клиент загружает папку, внутри которой есть SKILL.md, а произвольная HTTP-ссылка на файл сама по себе не является механизмом установки. Поэтому сначала нужно определить каталог, который сканирует конкретный агент, и только затем выбирать способ доставки. Для Claude Code описаны три области с приоритетом enterprise, personal и project: пользовательский путь ~/.claude/skills/<name>/SKILL.md, проектный .claude/skills/<name>/SKILL.md и каталог навыка внутри плагина. Проектные skills могут находиться также в родительских .claude/skills до корня репозитория и во вложенных каталогах после чтения или редактирования соответствующей директории; символические ссылки поддерживаются. Для Codex источник перечисляет области от текущего рабочего каталога до системного /etc/codex/skills, включая .agents/skills репозитория и домашний каталог. Для остальных клиентов путь нужно сверять с их актуальной документацией: неправильный каталог может привести к тихому отсутствию навыка без явной ошибки. Workflow предлагает четыре варианта с разным уровнем усилий. Самый простой — скопировать папку в уже сканируемый каталог; это работает широко, но не даёт автоматического обновления. Для проектного навыка предпочтительна фиксация в репозитории, чтобы структура версионировалась вместе с кодом. Третий вариант — Claude Code marketplace. В marketplace.json можно указать source: "./", ограниченный массив skills, strict: false, описание и version; затем пользователь добавляет marketplace и устанавливает конкретный plugin. Массив skills важен, если в одной папке лежат независимые плагины: без ограничения записи могут загрузить всю директорию. Версию нужно повышать при выпуске обновления. Четвёртый путь — архив и командная установка. Источник приводит tar.gz, который распаковывается в каталог навыков через curl и tar, и отдельно рекомендует предлагать zip для браузерной установки или клиентов, которые принимают архив. Обычная ссылка на SKILL.md не заменяет распаковку папки. Есть и отдельная ловушка marketplace по URL: если скачан только marketplace.json, относительный source может не разрешиться. Для такого размещения каждой записи нужен git-источник, GitHub, URL на git-репозиторий или npm; относительные пути надёжнее работают из клонированного marketplace. Перед публикацией проверяются frontmatter с name и description, совпадение имени директории с командой, ссылки на bundled scripts через ${CLAUDE_SKILL_DIR}, разбор marketplace.json и существование каждого пути со своим SKILL.md. Последний шаг — реальная установка на чистой машине ровно той командой, которую получит пользователь: прочитать инструкцию недостаточно, потому что ошибки пути и упаковки могут не дать сообщения об ошибке. Навык не пишет содержимое чужого SKILL.md, не обещает безопасность исполняемого кода и не делает публикацию автоматически; он помогает выбрать проверяемый способ доставки и не выдать ссылку за установщик.