Skip to content

Add Claude Code Plugin marketplace support (--tool claude-plugin) #261

@jasonz-ncc42

Description

@jasonz-ncc42

Summary

Add support for distributing agency-agents as a proper Claude Code plugin via marketplace, in addition to the existing --tool claude-code integration that copies agents to ~/.claude/agents/.

Motivation

Claude Code's plugin system (via /plugin marketplace add) provides:

  • Discoverability — users browse and install via /plugin UI
  • Auto-updates — marketplace refresh pulls latest agents automatically
  • Versioning — proper semver tracking via plugin.json
  • Clean install/uninstall — managed by Claude Code, not manual file copies
  • Namespacingagency-agents:seo-specialist avoids conflicts with other plugins

Currently --tool claude-code copies 150+ .md files to ~/.claude/agents/, which:

  • Pollutes the user-level agents directory
  • Has no uninstall mechanism (manual deletion)
  • No auto-update support
  • Can conflict with agents from other sources

Proposed Changes

1. convert.sh — add claude-plugin tool

Converts all division agents into a single plugin under integrations/claude-plugin/agency-agents/:

integrations/claude-plugin/agency-agents/
├── .claude-plugin/
│   └── plugin.json          # Plugin manifest
└── agents/
    └── *.md                 # Converted agent files (kebab-case names)

2. Marketplace file at repo root

Add .claude-plugin/marketplace.json at repository root so the repo itself can be added as a marketplace:

{
  "name": "agency-agents",
  "owner": { "name": "The Agency" },
  "plugins": [
    {
      "name": "agency-agents",
      "source": "./integrations/claude-plugin/agency-agents",
      "description": "150+ specialized AI agent personalities for every domain"
    }
  ]
}

3. install.sh — add claude-plugin tool

Instead of copying files, prints installation instructions:

/plugin marketplace add msitarzewski/agency-agents
/plugin install agency-agents@agency-agents

Installation (user experience)

# From Claude Code:
/plugin marketplace add msitarzewski/agency-agents
/plugin install agency-agents@agency-agents
/reload-plugins

All 150+ agents become available as agency-agents:agent-name in any project.

References

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions