Agent skill

Distribution

by ai-driven-dev in ai-driven-dev/framework

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…

MITAuto-check passedDevelopment

Install Distribution

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

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ai-driven-dev/framework distribution --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ai-driven-dev/framework.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cli/.claude/skills/distribution .claude/skills/distribution && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
distribution
GitHub stars
510
Token cost
~1.1k tokens
SKILL.md length
490 words
Files
1
Skills in repo
52
Repo updated
First seen
Licence
MIT

At a glance

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…

  • Adding a new marketplace source kind
  • SKILL.md covers What goes in, How, Public surface and How it's tested
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • A catalog parser for a foreign format

What it does

Distribution is an agent skill from ai-driven-dev/framework. 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.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. It works with Git. The repository describes itself as: Marketplace Framework AI-Driven Dev : Context Engineering, Plugins, Agents, Skills, Hooks, Templates, SDLC. The licence is MIT.

When your agent uses it

  • Adding a new marketplace source kind
  • A catalog parser for a foreign format
  • A fetch/cache/trust-store adapter
  • What a tool does with fetched content — use tools

Example prompts

  • “/distribution”

What it can do on your machine

Read from SKILL.md and the folder at commit 6e30640. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Distribution loads about 1.1k tokens when it runs. Until then it costs about 124 tokens; SKILL.md has 490 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~124
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ai-driven-dev/framework at commit 6e30640, republished under its MIT licence (© ai-driven-dev). 490 words, ~1,074 tokens.

Download SKILL.mdSave it as .claude/skills/distribution/SKILL.md (or your agent's skills folder).
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

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

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.
Show full SKILL.md (140 more words)Show less

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. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in cli/.claude/skills/distribution of ai-driven-dev/framework.

Open the folder on GitHubat commit 6e30640

Compare with similar skills

Distribution next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Distribution compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Distribution this skillai-driven-dev/framework510—~1.1kAutomated safety check: PassMIT
Finishing a Development Branchobra/superpowers296k5 repos~1.9kAutomated safety check: PassMIT
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT
Codebase Knowledge Graph Q&AEgonex-AI/Understand-Anything85k1 repos~1.2kAutomated safety check: PassMIT
Code Design Rationale Investigatorcursor/plugins10k9 repos~2.6kAutomated safety check: PassNone
Understand Diff AnalysisEgonex-AI/Understand-Anything85k1 repos~1.4kAutomated safety check: PassMIT

Similar skills

  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    296k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Codebase Knowledge Graph Q&A

    Egonex-AI/Understand-Anything

    Answers questions about a codebase by searching a prebuilt knowledge graph of its files, functions, classes and dependencies, not by rereading every source file.

    85k GitHub starsUsed in 1 repo~1.2k tokens
    DevelopmentAuto-check passed
  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    10k GitHub starsUsed in 9 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Understand Diff Analysis

    Egonex-AI/Understand-Anything

    Reads your git changes or a pull request against a prebuilt knowledge graph of the project to explain what changed, which components are affected and what is risky.

    85k GitHub starsUsed in 1 repo~1.4k tokens
    DevelopmentAuto-check passed
  • Understand Explain

    Egonex-AI/Understand-Anything

    Gives an in-depth explanation of one file, function or module by reading the project's knowledge graph and checking that the graph is still fresh.

    85k GitHub starsUsed in 1 repo~1.3k tokens
    DevelopmentAuto-check passed

More from ai-driven-dev/framework

All 52 skills in this repo
  • 00 Async Dev

    ai-driven-dev/framework

    Drive the async-dev pipeline from one entry point, whether setup, run, or review.

    510 GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • 01 Plan

    ai-driven-dev/framework

    Turn a request, ticket, or file into a phased implementation plan.

    510 GitHub stars~517 tokensUpdated today
    Auto-check passed
  • 01 Sdlc

    ai-driven-dev/framework

    Autonomously orchestrates a request from framing to a draft pull request, isolating implementation, independent review, and final outcome challenge.

    510 GitHub stars~583 tokensUpdated today
    Auto-check passed
  • 02 Backlog

    ai-driven-dev/framework

    Orchestrates a product backlog end to end. An agent skill from ai-driven-dev/framework.

    510 GitHub stars~613 tokensUpdated today
    Auto-check passed
  • 00 Onboard

    ai-driven-dev/framework

    Guide a project's journey through AIDD, from first setup to shipping a feature.

    510 GitHub stars~242 tokensUpdated today
    Auto-check passed
  • 01 Acceptance QA

    ai-driven-dev/framework

    Validate a reviewed candidate's observable behavior against its acceptance criteria and record short named videos as reviewer evidence.

    510 GitHub stars~434 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Distribution

What does Distribution do?

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…. Distribution is an agent skill from ai-driven-dev/framework. 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.

When should I use Distribution?

Distribution fits situations like: adding a new marketplace source kind; A catalog parser for a foreign format; A fetch/cache/trust-store adapter; what a tool does with fetched content — use tools.

How do I install Distribution in Claude Code?

Run `npx skills add ai-driven-dev/framework --skill distribution -a claude-code`. Or copy the skill folder (cli/.claude/skills/distribution in ai-driven-dev/framework) into .claude/skills/distribution in your project. Claude Code loads it when a task matches its description.

How do I install Distribution in Codex?

Run `npx skills add ai-driven-dev/framework --skill distribution -a codex`. Or copy the skill folder (cli/.claude/skills/distribution in ai-driven-dev/framework) into .agents/skills/distribution in your project. Codex loads it when a task matches its description.

Can I use Distribution in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ai-driven-dev/framework --skill distribution -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/distribution, .gemini/skills/distribution, .github/skills/distribution and .opencode/skills/distribution in your project.

What does Distribution need to run?

SKILL.md names no scripts, command-line tools or credentials: Distribution is instructions for the agent only.

Does Distribution access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Distribution safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Distribution use?

Distribution is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Distribution use?

About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Distribution?

Skills that share tags, products or a category with Distribution: Finishing a Development Branch (obra/superpowers, 296k stars), Code Review Checklist (shareAI-lab/learn-claude-code, 78k stars), Codebase Knowledge Graph Q&A (Egonex-AI/Understand-Anything, 85k stars) and Code Design Rationale Investigator (cursor/plugins, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Distribution?

ai-driven-dev (a GitHub organization) maintains it in ai-driven-dev/framework, which has 510 GitHub stars. The repository holds 52 skills in this directory. The repository was last updated on October 7, 2026.

Source: ai-driven-dev/framework on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.