Initial commit: Fresh start with current state
This commit is contained in:
Claude Code
241
.claude/PLUGIN_SETUP.md
Normal file
241
.claude/PLUGIN_SETUP.md
Normal file
@@ -0,0 +1,241 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user