К основному содержанию
скилл CX Codex

distribution — скилл для Claude Code: управление источниками контента

Скилл distribution для Claude Code, Cursor и других редакторов, который отвечает за то, откуда приходит контент плагинов и маркетплейсов и как его загружать.

MIT ★ 571 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add ai-driven-dev/framework --skill distribution -a claude-code
Открыть на GitHub

Что делает distribution

distribution работает на Claude Code, Cursor, Codex, GitHub Copilot и OpenCode. Это листовой контекст внутри фреймворка: он зависит только от kernel и не знает о tool, translate или framework. Единственная его задача — ответить, откуда берётся контент и как его загрузить.

Внутри distribution три уровня. В domain/ живут модели маркетплейса, формат каталога и парсеры для чужих форматов. В application/ — юз-кейсы для добавления, списания, обновления и разрешения источников маркетплейса. В infrastructure/ — конкретные адаптеры: для файловой системы, HTTP, Git и кэша. Каждый адаптер держит свои константы — URL API, TTL кэша, регексы для ошибок третьих сервисов.

Важная граница: distribution ничего не делает с загруженным контентом и не записывает, что установилось на проект. Это работа framework. Архитектурный тест блокирует любую новую связь distribution → tools, translate или framework; если изменение кажется нужным — оно должно быть в caller'е, не здесь.

Какие задачи решает

  • добавить новый источник маркетплейса или его вариант
  • написать парсер для каталога в чужом формате
  • реализовать адаптер для загрузки и кэширования контента
  • управлять доверенными хранилищами и регистрациями маркетплейсов
  • отделить логику источников контента от логики его использования

Примеры запросов агенту

  • Добавь парсер для маркетплейса в формате OpenAPI в domain/catalog-parsers/
  • Реализуй адаптер для HTTPS с кэшем TTL в infrastructure/
  • Напиши юз-кейс регистрации нового источника в application/

Как установить distribution

1Через Skills CLI (Vercel)

npx skills add ai-driven-dev/framework --skill distribution -a claude-code

2Вручную: положить файлы

~/.claude/skills/distribution/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/distribution/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о distribution

Как установить distribution на Claude Code?

Запусти npx skills add ai-driven-dev/framework --skill distribution -a claude-code, затем открой файл ~/.claude/skills/distribution/SKILL.md.

Что делает distribution?

Управляет, откуда приходит контент плагинов и маркетплейсов: регистрирует источники, парсит каталоги, кэширует и загружает через Git и HTTP. Ничего не делает с контентом после загрузки — это задача фреймворка.

Когда не нужен distribution?

Не используй для логики работы с загруженным контентом — используй tools или translate. Для записи, что установилось на проект, используй framework.

Исходный текст

SKILL.md · MIT
---
name: distribution
description: >
  Owns where plugin and marketplace content comes from and how it is fetched, under
  src/contexts/distribution/ — marketplace registration, catalog parsing, and the ports/adapters
  that reach git and HTTP. Use when adding a new marketplace source kind, a catalog parser for a
  foreign format, or a fetch/cache/trust-store adapter. Do NOT use for what a tool does with
  fetched content — use `tools` or `translate`. Do NOT use for recording what got installed on a
  project — use `framework`.
---

# Distribution

`distribution` is a leaf: it depends on `kernel` only, and knows no tool and no manifest. It
answers exactly one question — where does content come from, and how is it fetched — for
whoever asks. `framework` is the only context that reaches it (`framework → distribution`); a
plugin's own content and how it gets translated are someone else's job once it has arrived here.

## What goes in

| Concept | Location |
|---|---|
| A marketplace registration (name, source, scope, staleness) | `domain/marketplace.ts`, `domain/marketplace-source-mode.ts` |
| A cached catalog fetch | `domain/ports/marketplace-cache.ts` |
| The plugin catalog shape | `domain/catalog.ts` (the Claude-shaped parser lives here too) |
| A reader for a non-Claude catalog shape | `domain/catalog-parsers/` |
| A port this context's callers hold | `domain/ports/` — registry, cache, trust-store, catalog-repository, fetcher, raw-catalog-fetcher |
| Add / list / refresh / register / resolve / fetch a marketplace source | `application/` |
| The concrete adapter behind one of the six ports | `infrastructure/` |

## How

- This context is a leaf by construction: it must never gain an edge to `tools`, `translate`, or
  `framework` — `tests/architecture/context-graph.arch.test.ts` enforces the chain
  (`framework → distribution`, plus everything to `kernel`) and fails the build the moment a new
  edge appears. If a change seems to need one, the orchestration belongs to the caller
  (`framework`), not here — see `BASELINE` in `tests/architecture/helpers.ts` for the one
  documented exception, `distribution->framework`, and the comment there that explains it
  (`marketplace add --overwrite` removing before adding), which is framework work that has not
  yet been moved out.
- A port here follows the port/adapter rule in `.claude/rules/00-architecture/`: interface only, ≤5
  methods, no `null` in the return type unless "not found" is genuinely a normal domain state
  (documented per-port, not assumed).
- An adapter owns every technical constant for its integration (API base URLs, cache TTLs,
  error-pattern regexes for classifying a third-party failure) — none of that belongs in a port,
  a use-case, or a domain model. `try/catch` inside an adapter exists only to translate a raw
  error into a typed one from `kernel/errors.ts`.
- A new foreign catalog shape gets its own parser in `domain/catalog-parsers/`, producing the
  same `PluginCatalog`/`PluginCatalogEntry` shape the Claude parser produces — callers above this
  context never branch on which format a catalog came from.
- Follow the use-case rule in `.claude/rules/00-architecture/` for the application layer's shape.

## Public surface

Nothing outside `contexts/distribution/` may import a module this context has not declared
public — `tests/architecture/context-boundary.arch.test.ts` holds the list
(`PUBLIC_MODULES.distribution`). Measured at extraction, ten modules were reached from outside
and not one was an adapter: the adapters are wired by the composition root
(`runtime/wiring/distribution.ts`) alone, and stay internal for that reason. A module that
exposes its own plumbing to a caller outside the composition root is not a leaf context anymore
— keep new adapters unreachable from outside.

## How it's tested

- `tests/contexts/distribution/` mirrors `src/contexts/distribution/` — domain models and
  application use-cases are unit-tier; adapters against a real temp filesystem or a mocked
  network boundary are integration-tier. See the `test` skill for tier conventions.
- A new catalog parser needs a fixture of the real foreign format and a test asserting the parsed
  `PluginCatalog` matches what the Claude-shaped parser would produce for an equivalent catalog.

© ai-driven-dev · MIT · ai-driven-dev/framework

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
distribution-channels kostja94 Скилл distribution-channels помогает выбрать маркетплейсы и витрины приложений для дистрибуции продукта, а также подготовить листинги для них. CX Codex +1 1 100установок marketplace-catalog-sync vtex Скилл marketplace-catalog-sync помогает писать коннектор продавца, который отправляет товары в маркетплейс VTEX и держит цены с остатками в актуальном состоянии. CX Codex +1 1 100установок advanced-features-2025 JosiahSiegel Скилл advanced-features-2025 для Claude Code настраивает хуки, MCP-серверы и распространение плагинов на уровне репозитория. Описывает сборку плагинов Claude Code для команды. CX Codex +1 159установок oss-distribution-strategy Samuel Berthe Скилл oss-distribution-strategy помогает мейнтейнеру выбрать, какие каналы продолжат приводить новых пользователей после запуска, а какие стоит отклонить. CX Codex +1 13 700установок community-publish Starchild-ai-agent Скилл community-publish разделяет выдачу публичного URL, отправку кода на GitHub и добавление проектов в каталог. Пригодится при публикации сервисов и настройке платного доступа. CX Codex +1 4 000установок skill-distribution-audit официальный github Скилл skill-distribution-audit для GitHub Copilot проверяет репозитории со скиллами перед релизом. Сверяет исходные файлы с манифестом дистрибуции и реальной поисковой выдачей клиента. CX Codex +1 ★ 41 430звёзд репо

Из того же набора80

Весь набор →
04-audit Скилл 04-audit проверяет кодовую базу в режиме чтения по семи направлениям качества и собирает единый отчёт с приоритетами. Код он не меняет. CX Codex +1 ★ 571звёзд репо 01-bootstrap Скилл 01-bootstrap помогает спроектировать архитектуру нового SaaS и записывает решения в aidd_docs/INSTALL.md. Запускайте его в начале проекта, когда выбираете стек и архитектурный подход. CX Codex +1 ★ 571звёзд репо checker Субагент checker, который судит готовую работу по чеклисту, запускает валидацию и проверяет, служит ли код реальной потребности. Не правит код, только выносит вердикт с доказательствами. CX Codex +1 ★ 571звёзд репо 04-fact-check Скилл 04-fact-check проверяет фактические утверждения в тексте по источникам и переписывает его со сносками, помечая непроверенное. Скилл не оценивает программный код. CX Codex +1 ★ 571звёзд репо translate Скилл собирает конвейер перевода канонического исходника в нативный контент для каждого инструмента: трансформы, PluginContentTranslator и стратегии сборки за aidd translate и aidd sync. CX Codex +1 ★ 571звёзд репо tools Скилл tools помогает описывать профили сред разработки и ИИ-ассистентов в кодовой базе фреймворка, их контракты сборки и поддерживаемые возможности. CX Codex +1 ★ 571звёзд репо framework Скилл framework для Claude Code, Cursor и других платформ, который отслеживает все установленные файлы проекта и управляет их жизненным циклом. Координирует установку, восстановление, диагностику и удаление через единый манифест. CX Codex +1 ★ 571звёзд репо 00-async-dev Скилл 00-async-dev для Claude Code проводит задачу по async-конвейеру: от настройки репозитория до запуска готовой задачи и разбора замечаний в PR. CX Codex +1 ★ 571звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой