feat: Convert to Claude Code plugin marketplace
Transform repository into a plugin marketplace structure with two plugins: - claude-code plugin: Complete toolkit with 5 skills * claude-code-plugins * claude-code-slash-commands * claude-code-hooks * claude-code-subagents * claude-code-memory - claude-skills plugin: Meta-skill for creating Agent Skills * Comprehensive best practices guide * Templates and examples * Progressive disclosure patterns Infrastructure: - Add marketplace.json manifest - Create plugin.json for each plugin - Update documentation for marketplace structure - Add contribution and testing guides Installation: - /plugin install claude-code@claude-skills - /plugin install claude-skills@claude-skills 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
movq
363
README.md
Normal file
363
README.md
Normal file
@@ -0,0 +1,363 @@
|
||||
# Claude Skills Marketplace
|
||||
|
||||
A curated marketplace of Agent Skills and plugins for Claude Code and Claude.ai, designed to extend Claude's capabilities with specialized knowledge and workflows.
|
||||
|
||||
## What's in This Marketplace
|
||||
|
||||
### 🔧 claude-code Plugin
|
||||
Complete toolkit for mastering Claude Code features.
|
||||
|
||||
**Includes 5 specialized skills:**
|
||||
- **claude-code-plugins** - Create and structure plugins
|
||||
- **claude-code-slash-commands** - Build custom commands
|
||||
- **claude-code-hooks** - Set up event-driven automation
|
||||
- **claude-code-subagents** - Refine and troubleshoot subagents
|
||||
- **claude-code-memory** - Optimize CLAUDE.md files
|
||||
|
||||
[View Plugin Details](./claude-code/README.md)
|
||||
|
||||
### 📚 claude-skills Plugin
|
||||
Meta-skill for creating effective Agent Skills.
|
||||
|
||||
**Comprehensive guide covering:**
|
||||
- Progressive disclosure architecture
|
||||
- Trigger optimization techniques
|
||||
- Token efficiency strategies
|
||||
- Development workflows
|
||||
- Templates and examples
|
||||
|
||||
[View Plugin Details](./claude-skills-plugin/README.md)
|
||||
|
||||
## Quick Start
|
||||
|
||||
### For Claude Code
|
||||
|
||||
Install individual plugins from this marketplace:
|
||||
|
||||
```bash
|
||||
# Install Claude Code plugin
|
||||
/plugin install claude-code@local --path /path/to/Skills
|
||||
|
||||
# Install Claude Skills plugin
|
||||
/plugin install claude-skills@local --path /path/to/Skills
|
||||
```
|
||||
|
||||
Or configure the marketplace in your settings:
|
||||
|
||||
```json
|
||||
// ~/.claude/settings.json or .claude/settings.json
|
||||
{
|
||||
"plugin-marketplaces": {
|
||||
"claude-skills": {
|
||||
"url": "file:///path/to/Skills"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Then install from the marketplace:
|
||||
|
||||
```bash
|
||||
/plugin install claude-code@claude-skills
|
||||
/plugin install claude-skills@claude-skills
|
||||
```
|
||||
|
||||
### For Claude.ai
|
||||
|
||||
Each plugin can be zipped and uploaded individually:
|
||||
|
||||
1. Zip a plugin directory (e.g., `claude-code/`)
|
||||
2. Go to Settings > Capabilities > Upload skill
|
||||
3. Upload the zip file
|
||||
4. Enable the plugin
|
||||
|
||||
## Available Plugins
|
||||
|
||||
| Plugin | Version | Skills | Description |
|
||||
|--------|---------|--------|-------------|
|
||||
| [claude-code](./claude-code/) | 1.0.0 | 5 | Complete Claude Code toolkit |
|
||||
| [claude-skills](./claude-skills-plugin/) | 1.0.0 | 1 | Skill creation meta-guide |
|
||||
|
||||
## Plugin Details
|
||||
|
||||
### claude-code
|
||||
|
||||
**Best for:** Claude Code users who want to master plugins, commands, hooks, subagents, and memory management.
|
||||
|
||||
**Skills included:**
|
||||
1. `claude-code-plugins` - Plugin development
|
||||
2. `claude-code-slash-commands` - Custom command creation
|
||||
3. `claude-code-hooks` - Event-driven automation
|
||||
4. `claude-code-subagents` - Subagent optimization
|
||||
5. `claude-code-memory` - Memory file management
|
||||
|
||||
**Installation:**
|
||||
```bash
|
||||
/plugin install claude-code@claude-skills
|
||||
```
|
||||
|
||||
### claude-skills
|
||||
|
||||
**Best for:** Anyone creating Agent Skills for Claude Code or Claude.ai.
|
||||
|
||||
**What it teaches:**
|
||||
- How to structure skills effectively
|
||||
- Writing descriptions that trigger correctly
|
||||
- Optimizing for token efficiency
|
||||
- Progressive disclosure patterns
|
||||
- Testing and validation
|
||||
|
||||
**Installation:**
|
||||
```bash
|
||||
/plugin install claude-skills@claude-skills
|
||||
```
|
||||
|
||||
## How This Marketplace Works
|
||||
|
||||
### Marketplace Structure
|
||||
|
||||
```
|
||||
claude-skills-marketplace/
|
||||
├── .claude-plugin/
|
||||
│ └── marketplace.json # Marketplace manifest
|
||||
├── claude-code/ # Plugin 1
|
||||
│ ├── .claude-plugin/
|
||||
│ │ └── plugin.json
|
||||
│ ├── skills/ # 5 Claude Code skills
|
||||
│ └── README.md
|
||||
├── claude-skills-plugin/ # Plugin 2
|
||||
│ ├── .claude-plugin/
|
||||
│ │ └── plugin.json
|
||||
│ ├── skills/ # Skill creation guide
|
||||
│ └── README.md
|
||||
├── README.md # This file
|
||||
├── CONTRIBUTING.md # How to add plugins/skills
|
||||
└── TESTING.md # Validation guide
|
||||
```
|
||||
|
||||
### Plugin Installation Flow
|
||||
|
||||
1. **Marketplace Configuration** - Add marketplace to settings
|
||||
2. **Discovery** - Claude Code reads marketplace.json
|
||||
3. **Installation** - `/plugin install [plugin-name]@[marketplace-name]`
|
||||
4. **Activation** - Skills load automatically based on context
|
||||
|
||||
## Usage Examples
|
||||
|
||||
### Working with Claude Code Features
|
||||
|
||||
```
|
||||
# Plugin development
|
||||
"Help me create a plugin for my team"
|
||||
→ claude-code-plugins skill activates
|
||||
|
||||
# Custom commands
|
||||
"I want to create a slash command for code review"
|
||||
→ claude-code-slash-commands skill activates
|
||||
|
||||
# Setting up automation
|
||||
"How do I run tests automatically after file edits?"
|
||||
→ claude-code-hooks skill activates
|
||||
|
||||
# Subagent issues
|
||||
"My security analyzer subagent isn't triggering"
|
||||
→ claude-code-subagents skill activates
|
||||
|
||||
# Memory optimization
|
||||
"My CLAUDE.md file is too long and wastes tokens"
|
||||
→ claude-code-memory skill activates
|
||||
```
|
||||
|
||||
### Creating New Skills
|
||||
|
||||
```
|
||||
"I want to create a skill for React testing"
|
||||
→ claude-skills skill activates
|
||||
→ Guides you through templates and best practices
|
||||
```
|
||||
|
||||
## Team Setup
|
||||
|
||||
Share this marketplace with your team:
|
||||
|
||||
### Option 1: Git Repository (Recommended)
|
||||
|
||||
```bash
|
||||
# Team members clone the repo
|
||||
git clone https://your-repo/claude-skills-marketplace.git
|
||||
|
||||
# Add to Claude Code settings
|
||||
# .claude/settings.json (committed to repo)
|
||||
{
|
||||
"plugin-marketplaces": {
|
||||
"team-skills": {
|
||||
"url": "file:///path/to/claude-skills-marketplace"
|
||||
}
|
||||
},
|
||||
"plugins": [
|
||||
"claude-code@team-skills",
|
||||
"claude-skills@team-skills"
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
Benefits:
|
||||
- Version control for skills
|
||||
- Team consistency
|
||||
- Easy updates via `git pull`
|
||||
|
||||
### Option 2: Network Share
|
||||
|
||||
```json
|
||||
{
|
||||
"plugin-marketplaces": {
|
||||
"team-skills": {
|
||||
"url": "file://network-share/claude-skills"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Option 3: Individual Installation
|
||||
|
||||
Team members install plugins locally:
|
||||
|
||||
```bash
|
||||
/plugin install /local/path/to/claude-code@local
|
||||
/plugin install /local/path/to/claude-skills@local
|
||||
```
|
||||
|
||||
## Best Practices
|
||||
|
||||
### For Plugin Users
|
||||
|
||||
1. **Start with claude-skills** if you're creating skills
|
||||
2. **Install claude-code** if you use Claude Code regularly
|
||||
3. **Keep plugins updated** - Check for new versions
|
||||
4. **Test in local settings** before team-wide deployment
|
||||
|
||||
### For Skill Creators
|
||||
|
||||
1. Follow [CONTRIBUTING.md](./CONTRIBUTING.md) guidelines
|
||||
2. Test skills thoroughly (see [TESTING.md](./TESTING.md))
|
||||
3. Use progressive disclosure (keep main content lean)
|
||||
4. Include concrete examples
|
||||
5. Write specific trigger descriptions
|
||||
|
||||
### For Teams
|
||||
|
||||
1. **Share marketplace via git** for version control
|
||||
2. **Document custom workflows** in team CLAUDE.md
|
||||
3. **Create team-specific plugins** for your stack
|
||||
4. **Regular reviews** of skill effectiveness
|
||||
|
||||
## Customization
|
||||
|
||||
### Adding Your Own Plugins
|
||||
|
||||
1. Create plugin directory with structure:
|
||||
```
|
||||
your-plugin/
|
||||
├── .claude-plugin/
|
||||
│ └── plugin.json
|
||||
├── skills/
|
||||
│ └── your-skill/
|
||||
│ └── SKILL.md
|
||||
└── README.md
|
||||
```
|
||||
|
||||
2. Update marketplace.json:
|
||||
```json
|
||||
{
|
||||
"plugins": [
|
||||
{
|
||||
"name": "your-plugin",
|
||||
"source": "./your-plugin",
|
||||
"description": "Your plugin description"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
3. See [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed guidelines
|
||||
|
||||
### Creating Custom Skills
|
||||
|
||||
Use the **claude-skills** plugin to guide you:
|
||||
|
||||
```
|
||||
"Help me create a skill for [your domain]"
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Plugins Not Installing
|
||||
|
||||
**Check marketplace configuration:**
|
||||
```bash
|
||||
# Verify marketplace.json exists
|
||||
cat .claude-plugin/marketplace.json
|
||||
|
||||
# Check file paths are correct
|
||||
ls claude-code/.claude-plugin/plugin.json
|
||||
ls claude-skills-plugin/.claude-plugin/plugin.json
|
||||
```
|
||||
|
||||
### Skills Not Triggering
|
||||
|
||||
**Verify installation:**
|
||||
```bash
|
||||
/plugin list
|
||||
# Should show: claude-code, claude-skills
|
||||
```
|
||||
|
||||
**Check descriptions:** Skills may not match your use case
|
||||
- Read plugin READMEs for trigger scenarios
|
||||
- Try explicit skill references in prompts
|
||||
|
||||
### Updates Not Applying
|
||||
|
||||
**Reload plugins:**
|
||||
```bash
|
||||
# Restart Claude Code session
|
||||
# Or reinstall plugin
|
||||
/plugin uninstall claude-code
|
||||
/plugin install claude-code@claude-skills
|
||||
```
|
||||
|
||||
## Contributing
|
||||
|
||||
We welcome contributions! See [CONTRIBUTING.md](./CONTRIBUTING.md) for:
|
||||
- Adding new skills
|
||||
- Improving existing skills
|
||||
- Creating new plugins
|
||||
- Documentation improvements
|
||||
- Bug reports
|
||||
|
||||
## Resources
|
||||
|
||||
### Official Documentation
|
||||
- [Agent Skills Overview](https://docs.claude.com/en/docs/agents-and-tools/agent-skills/overview)
|
||||
- [Claude Code Plugins](https://docs.claude.com/en/docs/claude-code/plugins)
|
||||
- [Sub-agents](https://docs.claude.com/en/docs/claude-code/sub-agents)
|
||||
- [Memory Management](https://docs.claude.com/en/docs/claude-code/memory)
|
||||
|
||||
### Community
|
||||
- [Engineering Blog: Agent Skills](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills)
|
||||
- [Engineering Blog: Claude Code Best Practices](https://www.anthropic.com/engineering/claude-code-best-practices)
|
||||
|
||||
## Version History
|
||||
|
||||
### 1.0.0 (Initial Release)
|
||||
- claude-code plugin (5 skills)
|
||||
- claude-skills plugin (meta-skill)
|
||||
- Marketplace infrastructure
|
||||
- Documentation and guides
|
||||
|
||||
## License
|
||||
|
||||
Individual plugins may have their own licenses. Check each plugin directory for details.
|
||||
|
||||
---
|
||||
|
||||
**Get Started**: Install the plugins, explore the skills, and level up your Claude Code workflow!
|
||||
Reference in New Issue
Block a user