Plugin Development¶

Welcome to the Talent Factory Claude Plugins development guide! This section helps you create, test, and contribute plugins to the marketplace.

Quick Links¶

Getting Started¶

Prerequisites¶

• Claude Code installed
• Git for version control
• Basic understanding of Markdown
• Familiarity with JSON

Development Workflow¶

graph LR
    A[Fork Repository] --> B[Create Plugin]
    B --> C[Write Commands]
    C --> D[Test Locally]
    D --> E[Validate]
    E --> F[Submit PR]
    F --> G[CI Validation]
    G --> H[Review]
    H --> I[Merge]
    I --> J[Deploy]

Plugin Structure¶

A typical plugin has this structure:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

plugins/your-plugin/
├── .claude-plugin/
│   └── plugin.json          # Plugin metadata
├── commands/
│   ├── command1.md          # Command definitions
│   └── command2.md
├── agents/                  # Optional
│   └── agent1.md            # Agent definitions
├── skills/                  # Optional
│   └── skill1/              # Skill definitions
├── references/              # Optional
│   └── docs.md              # Reference documentation
└── README.md                # Plugin documentation

Quick Start: Create Your First Plugin¶

1. Fork the Repository¶

1
2
3

git clone https://github.com/YOUR-USERNAME/claude-plugins.git
cd claude-plugins
git checkout -b feature/add-my-plugin

2. Create Plugin Structure¶

1
2

mkdir -p plugins/my-plugin/.claude-plugin
mkdir -p plugins/my-plugin/commands

3. Create plugin.json¶

1
2
3
4
5
6
7
8
9

{
  "name": "my-plugin",
  "version": "1.0.0",
  "displayName": "My Plugin",
  "description": "Brief description of your plugin",
  "keywords": ["tag1", "tag2"],
  "author": "Your Name",
  "license": "MIT"
}

4. Create a Command¶

Create plugins/my-plugin/commands/my-command.md:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

# My Command

Brief description of what this command does.

## Usage

/my-command [options]

## Purpose

Explain when and why to use this command.

## Instructions

1. Step-by-step instructions
2. What the command should do
3. Expected outcomes

## Examples

### Example 1: Basic Usage

/my-command

### Example 2: With Options

/my-command --option value

5. Create README¶

Create plugins/my-plugin/README.md:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

# My Plugin

Description of your plugin.

## Commands

### `/my-command`

Brief description.

**Usage:**

/my-command [options]

## Installation

See [Installation Guide](../../docs/getting-started/installation.md)

6. Update Marketplace¶

Add your plugin to .claude-plugin/marketplace.json:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

{
  "plugins": [
    {
      "name": "my-plugin",
      "description": "Brief description",
      "source": "./plugins/my-plugin",
      "version": "1.0.0",
      "tags": ["tag1", "tag2"]
    }
  ]
}

7. Test Locally¶

1
2
3
4
5

# Test your plugin
claude --plugin-dir ./plugins/my-plugin

# In Claude Code session
/my-command

8. Validate¶

1
2
3

# Use core plugin validation
/check-commands
/check-agents

9. Submit PR¶

1
2
3

git add .
git commit -m "✨ feat: Füge my-plugin hinzu"
git push origin feature/add-my-plugin

Create a pull request on GitHub.

Development Tools¶

Core Plugin Commands¶

The core plugin provides development utilities:

• /check-commands - Validate command markdown files
• /check-agents - Validate agent definitions
• /create-command - Generate new command templates
• /build-skill - Create Claude Code Skills
• /run-ci - Run CI checks locally

Local Testing¶

1
2
3
4
5

# Test single plugin
claude --plugin-dir ./plugins/your-plugin

# Test entire marketplace
claude --plugin-dir .

Next Steps¶