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

# Start Claude Code
claude

# Open plugin menu
> /plugin

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

Install a Plugin

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

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

Manage Plugins

# 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:

{
  "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

> /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

# Refresh marketplace list
> /plugin marketplace refresh

# Verify marketplace is added
> /plugin marketplace list

Plugin Not Working

# 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

{
  "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