claude-plugins/README.md

# 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-plugins** - Create and structure plugins
- **claude-commands** - Build custom commands
- **claude-hooks** - Set up event-driven automation
- **claude-subagents** - Refine and troubleshoot subagents
- **claude-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-plugins` - Plugin development
2. `claude-commands` - Custom command creation
3. `claude-hooks` - Event-driven automation
4. `claude-subagents` - Subagent optimization
5. `claude-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-plugins skill activates

# Custom commands
"I want to create a slash command for code review"
→ claude-commands skill activates

# Setting up automation
"How do I run tests automatically after file edits?"
→ claude-hooks skill activates

# Subagent issues
"My security analyzer subagent isn't triggering"
→ claude-subagents skill activates

# Memory optimization
"My CLAUDE.md file is too long and wastes tokens"
→ claude-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!