Marketplaces

Marketplaces are collections of plugins hosted on GitHub.

Using Marketplaces

allagents plugin marketplace add anthropics/claude-plugins-official
allagents plugin marketplace list

Branch Selection

To register a marketplace from a non-default branch, use a full GitHub URL with the branch path or the --branch flag. A custom --name is required for non-default branches:

# Full GitHub URL with branch
allagents plugin marketplace add https://github.com/owner/repo/tree/feat/v2 --name repo-v2

# Shorthand with --branch flag
allagents plugin marketplace add owner/repo --branch feat/v2 --name repo-v2

The bare repo name (e.g., repo) is reserved for the default branch. Updates automatically pull the correct branch.

Recommended Catalog vs. Marketplaces

The built-in Recommended skill catalog is a static discovery index, not a MarketplaceRegistry entry. Interactive searches with no explicit owner or catalog show Recommended first and deduplicated All GitHub results second. Use the explicit flag for a strict catalog-only search suitable for scripts:

allagents skill search <query> --catalog recommended

The catalog includes heterogeneous source types: direct repositories, subtrees, valid marketplace-backed distributions, search-only repositories, and projects with an external installation lifecycle. Catalog inclusion does not make a source a marketplace or imply that it is one-click installable. Search-only sources cannot be selected. External-lifecycle sources show upstream guidance; AllAgents never executes their installer.

For a marketplace-backed catalog result, AllAgents validates the authoritative upstream manifest and registers it only when the user selects an installable skill. Project selection writes to the project-scoped registry; it does not mutate the user’s global marketplace registry. The catalog’s exact repository, default-branch ref, root, source identity, and selected skill paths are retained for sync. Sources with broken or ambiguous manifests are represented honestly as search-only rather than repaired with a generated manifest.

Recommended means curated for discovery only. It is not a security audit, trust endorsement, quality guarantee, or license assertion. Review upstream code and the per-result classification, policy, warnings, author, homepage, and license metadata before installation. Catalog health validation detects source drift; it does not vendor, rewrite, or automatically update upstream content.

Creating a Marketplace

my-marketplace/
├── plugins/
│   ├── code-review/
│   └── debugging/
└── README.md