plugin-dev

# Plugin Development

Develop and distribute Claude Code plugins and marketplaces.

## Quick Commands

```bash
# Validate marketplace/plugin
claude plugin validate .

# Test local install
/plugin marketplace add ./path/to/marketplace
/plugin install my-plugin@marketplace-name

# Check installed plugins
/plugin list
```

## Marketplace Schema

Required fields in `.claude-plugin/marketplace.json`:

```json
{
  "name": "marketplace-name",
  "owner": { "name": "Your Name" },
  "plugins": [
    {
      "name": "plugin-name",
      "source": "./plugins/plugin-name",
      "description": "What it does"
    }
  ]
}
```

## Plugin Schema

Required fields in `.claude-plugin/plugin.json`:

```json
{
  "name": "plugin-name",
  "description": "What it does",
  "version": "1.0.0"
}
```

## Common Errors

| Error                        | Fix                                 |
| ---------------------------- | ----------------------------------- |
| `owner: expected object`     | Add `"owner": { "name": "..." }`    |
| `plugins.0: expected object` | Change string array to object array |
| `source: Invalid input`      | Use `./path/to/plugin` format       |

## References

- [marketplace-schema.md](references/marketplace-schema.md) - Full marketplace fields
- [plugin-schema.md](references/plugin-schema.md) - Full plugin fields
- [validation-guide.md](references/validation-guide.md) - Debugging validation errors
- [distribution.md](references/distribution.md) - Publishing to GitHub