Скиллы Yango — контент

Здесь лежат сами скиллы. Каталог маркетплейса — в соседнем репозитории yango/skills-marketplace, там же инструкция по подключению для тех, кто просто хочет пользоваться.

Ставить скиллы отсюда руками не нужно: это делает Claude Code через маркетплейс. Этот репозиторий — рабочее место тех, кто скиллы пишет.

---

Что где

skills/                     скиллы без внешних зависимостей
  yango-group-design/       дизайн зонтичного бренда Yango Group
  yango-tech-design/        дизайн-система Yango Tech 2025 (продукт)
  yango-group-carousel-reel/  карусели и обложки Reels (YANGOGROUP-303)
  reels-scriptwriter/       сценарии Reels и каруселей
  podcast-content-factory/  подкаст → контент (ЧЕРНОВИК, не доведён)

plugins/                    скиллы, которым нужен Photo-search MCP
  yango-group-deck/
    .claude-plugin/plugin.json    бандлит MCP-сервер + спрашивает токен
    skills/yango-group-deck/
  yango-group-deck-live/

yango-group-design и yango-tech-design — разные бренды, а не версии одного скилла. Group — зонтичный, Tech — продуктовый (tech.yango.com). Раньше теховский назывался просто yango-design, из-за чего их регулярно путали; здесь он переименован.

Как обновить свой скилл

git clone https://git.nercy.org/yango/skills.git
cd skills
# правишь skills/<твой-скилл>/…
git add -A && git commit -m "что изменилось" && git push

Права на запись — у всех в команде, это не read-only витрина. Остальные подтянут изменение командами из шпаргалки; отдельно ничего пересылать не надо.

Клон один раз тяжёлый (~130 МБ ассетов), дальше идут только дельты.

Если нужно ещё и в Claude Desktop / claude.ai

Вкладка Code внутри Desktop — это тот же Claude Code, она читает тот же ~/.claude. Маркетплейс там работает сам, делать ничего не надо.

А основной чат Desktop и claude.ai берут скиллы из аккаунта, и туда они попадают только .skill-архивом через интерфейс. Публичного API для загрузки в личный аккаунт нет: /v1/skills — другой контур (API-воркспейс, ключ x-api-key), его скиллы в аккаунте не появляются.

Собрать архивы:

python3 tools/package-skills.py      # из корня репозитория

Появятся в dist/, дальше — перетащить в Desktop: Настройки → Skills. Автоматизируется только упаковка; загрузка ручная. Зато архивы собираются из того же единственного источника, что и маркетплейс, — расходиться нечему.

Три скилла тяжёлые (carousel-reel 47 МБ, deck 30 МБ, deck-live 23 МБ) — загрузку в аккаунт стоит проверить на них отдельно, лимит может не пустить.

dist/ в git не кладём: архивы полностью выводятся из исходников, а дубль контента раздул бы репозиторий вдвое.

Чего делать не надо

Не добавляй version в plugin.json. Закреплённая версия замораживает плагин: Claude Code видит ту же строку и держит кэш, сколько бы коммитов ни пришло. Без поля версией становится SHA коммита, и обновления доезжают сами. claude plugin validate предупредит про отсутствие version — это ожидаемо, предупреждение можно игнорировать.

Не клади скиллы .skill-архивами. Этот формат нужен Claude.ai и Cowork (кнопка «Save skill»). Тулинг Claude Code работает с папками напрямую, а архив ещё и прячет diff — не видно, что именно поменялось.

Не заводи второй frontmatter-блок в SKILL.md. Claude Code читает первый, второй молча уезжает в тело скилла. Такое уже было в reels-scriptwriter.

Если меняется состав скиллов

Новую папку нужно ещё прописать в каталоге — .claude-plugin/marketplace.json в репозитории yango/skills-marketplace. Правка существующего скилла ничего там менять не требует.

Ассеты

Крупные бинарники (шаблоны, шрифты, фото-пулы) лежат в git как есть, без LFS. Это сознательно: LFS потребовал бы установленного git-lfs на машине каждого участника, иначе клон приезжает с текстовыми заглушками вместо картинок.