copy-agent

Copy Agent

Copy an agent from Product Forge plugins to your user-level (~/.claude/) or project-level (.claude/) directory.

Usage

# List available agents
/copy-agent

# Copy to project (default)
/copy-agent product-design:product-architect

# Copy to user level
/copy-agent git-workflow:commit-expert --user

# Explicit project level
/copy-agent python-experts:django-expert --project

Arguments

• <plugin>:<agent-name> - The agent to copy in plugin:name format
• --user - Copy to ~/.claude/{plugin}/agents/{name}.md
• --project - Copy to .claude/{plugin}/agents/{name}.md (default)

What Gets Copied

Agents are single markdown files (.md) containing:

• YAML frontmatter with name, description, tools, model, and color
• Agent capabilities and activation triggers
• Autonomous workflow definitions

Directory Structure

# Project-level (default)
.claude/
└── git-workflow/
    └── agents/
        └── commit-expert.md

# User-level (--user)
~/.claude/
└── git-workflow/
    └── agents/
        └── commit-expert.md

Execution Instructions

When the user runs this command:

No Arguments - List Available Agents

1. Scan Product Forge plugins cache for all available agents:

   ls ~/.claude/plugins/cache/product-forge-marketplace/*/agents/*.md 2>/dev/null
   

2. For each plugin with agents, list them with descriptions:

   • Read agent file frontmatter to get name, description, and model
   • Format as: {plugin}:{agent-name} ({model}) - {description}

3. Display formatted list:

   Available agents from Product Forge:
   
   product-design:
     product-architect (sonnet) - Full product development guidance
     prd-orchestrator (sonnet) - PRD lifecycle management
     qa-tester (sonnet) - Manual QA test procedure creation
     web-debugger (sonnet) - Web application debugging
     ...
   
   git-workflow:
     commit-expert (haiku) - Git commit specialist
     rebase-expert (haiku) - Git rebase specialist
     code-review-expert (sonnet) - Code review orchestrator
     ...
   
   python-experts:
     django-expert (sonnet) - Django web application specialist
     fastapi-expert (sonnet) - FastAPI async REST API specialist
     ...
   
   Usage: /copy-agent <plugin>:<agent-name> [--user | --project]