FoundryVTT/.claude/PLUGIN_SETUP.md

# Plugin Marketplace Setup

> **Status**: ✅ Configured
> **Date**: 2025-10-17

## Configured Marketplaces

### 1. Anthropic Official Skills
- **Repository**: `anthropics/skills`
- **URL**: https://github.com/anthropics/skills
- **Description**: Official Anthropic plugin marketplace with curated plugins

## Using Plugins

### Browse Available Plugins

```bash
# Start Claude Code
claude

# Open plugin menu
> /plugin

# This will show:
# - Installed plugins
# - Available plugins from marketplaces
# - Installation options
```

### Install a Plugin

```bash
# Install specific plugin
> /plugin install <plugin-name>

# Example:
> /plugin install commit-helper
> /plugin install code-reviewer
```

### Manage Plugins

```bash
# List installed plugins
> /plugin list

# Uninstall plugin
> /plugin uninstall <plugin-name>

# Update plugin
> /plugin update <plugin-name>

# Update all plugins
> /plugin update --all
```

## Popular Plugins to Explore

From the Anthropic marketplace, consider:

### Development Workflows
- **commit-helper** - Generate conventional commit messages
- **pr-reviewer** - Automated pull request reviews
- **test-generator** - Create comprehensive test suites
- **refactor-assistant** - Code refactoring guidance

### Documentation
- **doc-writer** - Generate documentation from code
- **api-documenter** - Create API documentation
- **readme-generator** - Generate project README files

### Code Quality
- **security-scanner** - Security vulnerability detection
- **performance-analyzer** - Performance optimization suggestions
- **accessibility-checker** - WCAG compliance verification

### Debugging
- **error-explainer** - Detailed error explanations
- **log-analyzer** - Parse and analyze log files
- **bug-hunter** - Systematic bug tracking

## Adding Additional Marketplaces

To add more marketplaces, you have two options:

### Option 1: Via Settings (Recommended)

Edit `.claude/settings.json`:

```json
{
  "pluginMarketplaces": [
    {
      "name": "anthropics/skills",
      "url": "https://github.com/anthropics/skills",
      "description": "Official Anthropic plugin marketplace"
    },
    {
      "name": "community/plugins",
      "url": "https://github.com/community/plugins",
      "description": "Community-contributed plugins"
    }
  ]
}
```

### Option 2: Via Command Line

```bash
> /plugin marketplace add <user-or-org>/<repo-name>

# Example:
> /plugin marketplace add sethhobson/subagents
```

## Popular Community Marketplaces

### Seth Hobson's Subagents
- **Repository**: `sethhobson/subagents`
- **Description**: 80+ specialized subagents for various tasks
- **URL**: https://github.com/sethhobson/subagents

### Dave Ebbelaar's Prompts
- **Repository**: `daveebbelaar/prompts`
- **Description**: Community workflows and prompts
- **URL**: https://github.com/daveebbelaar/prompts

## Plugin Structure

When you install a plugin, it may include:
- **Commands** - Slash commands in `.claude/commands/`
- **Agents** - Subagents in `.claude/agents/`
- **Skills** - Auto-invoked capabilities in `.claude/skills/`
- **Hooks** - Event triggers in `.claude/hooks/`
- **MCP Servers** - External integrations

## Best Practices

### Plugin Management
1. **Review before installing** - Check what the plugin includes
2. **Test in isolation** - Try new plugins one at a time
3. **Disable unused plugins** - Keep your setup clean
4. **Update regularly** - Get latest features and fixes
5. **Uninstall conflicts** - Remove plugins that overlap

### Security
- Only install plugins from trusted sources
- Review plugin code before installation (available on GitHub)
- Check plugin permissions and tool access
- Be cautious with plugins that require extensive permissions

### Performance
- Don't install too many plugins at once
- Plugins add to system prompt context
- Disable plugins you're not actively using
- Monitor token usage with multiple plugins

## Troubleshooting

### Plugin Not Found
```bash
# Refresh marketplace list
> /plugin marketplace refresh

# Verify marketplace is added
> /plugin marketplace list
```

### Plugin Not Working
```bash
# Check if plugin is enabled
> /plugin list

# Reinstall plugin
> /plugin uninstall <plugin-name>
> /plugin install <plugin-name>

# Check plugin logs
# View .claude/logs/ for error messages
```

### Conflicts Between Plugins
If two plugins conflict:
1. Disable one plugin temporarily
2. Check which commands/agents overlap
3. Choose the plugin that better fits your needs
4. Or keep both and invoke specific versions

## Creating Your Own Plugins

Want to create a plugin for your team?

### Plugin Structure
```
my-plugin/
├── plugin.json           # Plugin metadata
├── commands/             # Slash commands
├── agents/              # Subagents
├── skills/              # Auto-invoked skills
├── hooks/               # Event hooks
└── README.md            # Documentation
```

### plugin.json Example
```json
{
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "Custom team workflows",
  "author": "Your Team",
  "commands": ["commands/*.md"],
  "agents": ["agents/*.md"],
  "skills": ["skills/*.md"],
  "hooks": ["hooks/*.sh"],
  "permissions": {
    "allow": ["Read(*)", "Grep(*)", "Glob(*)"]
  }
}
```

### Publishing Your Plugin
1. Create GitHub repository
2. Add plugin files with structure above
3. Tag releases (v1.0.0, v1.1.0, etc.)
4. Share repository URL with team
5. Others can install with: `/plugin marketplace add your-org/your-plugin`

## Next Steps

1. **Browse plugins**: Run `/plugin` to explore available plugins
2. **Install your first plugin**: Try a simple plugin like commit-helper
3. **Explore community**: Check out sethhobson/subagents for more options
4. **Create custom**: Build plugins for your team's specific workflows

---

**Marketplace Version**: 1.0.0
**Last Updated**: 2025-10-17
**Maintainer**: [Your Team]

For more information, see official docs: https://docs.claude.com/en/docs/claude-code/plugins