claude-plugins/claude-code/README.md

# Claude Code Plugin

Comprehensive skills for mastering Claude Code features including plugins, slash commands, hooks, subagents, and memory management.

## What's Included

This plugin provides five specialized skills that help you work more effectively with Claude Code:

### 1. claude-code-plugins
Create and structure Claude Code plugins with commands, agents, skills, hooks, and MCP servers.

**Use when:**
- Building plugins for Claude Code
- Setting up plugin structure
- Configuring plugin manifests

### 2. claude-code-slash-commands
Create custom slash commands with argument handling, bash execution, and file references.

**Use when:**
- Building reusable prompts
- Automating workflows
- Creating project-specific commands

### 3. claude-code-hooks
Configure event-driven hooks for automating workflows, validating code, and controlling tool execution.

**Use when:**
- Setting up automation
- Enforcing standards
- Injecting context
- Integrating external tools

### 4. claude-code-subagents
Refine and troubleshoot Claude Code subagents by optimizing prompts, tool access, and delegation patterns.

**Use when:**
- Improving existing subagents (NOT initial creation - use `/agents` command)
- Debugging activation issues
- Optimizing performance

### 5. claude-code-memory
Optimize and troubleshoot Claude Code memory files (CLAUDE.md) for efficiency, token management, and team collaboration.

**Use when:**
- Memory isn't loading
- Context is bloated
- Organizing memory hierarchy
- Setting up team collaboration (NOT initial setup - use `/init` command)

## Installation

### For Claude Code

Install from marketplace:

```bash
/plugin install claude-code@claude-skills-marketplace
```

Or install from local directory:

```bash
/plugin install /path/to/Skills/claude-code@local
```

### For Claude.ai

1. Zip this plugin directory
2. Go to Settings > Capabilities > Upload skill
3. Upload the zip file
4. Enable the plugin

## Usage

Once installed, these skills activate automatically when you work on related tasks:

- **Working on a plugin?** → claude-code-plugins skill activates
- **Creating slash commands?** → claude-code-slash-commands skill activates
- **Setting up hooks?** → claude-code-hooks skill activates
- **Refining a subagent?** → claude-code-subagents skill activates
- **Troubleshooting CLAUDE.md?** → claude-code-memory skill activates

You can also explicitly reference skills:
```
"Help me optimize my CLAUDE.md file"
"My subagent isn't triggering correctly"
"How do I create a hook that runs after file writes?"
```

## Skills Details

### claude-code-plugins

**Covers:**
- Plugin manifest configuration (plugin.json)
- Component setup (commands/agents/skills/hooks)
- Distribution and marketplace publishing
- Best practices and troubleshooting

[View Details](./skills/claude-code-plugins/SKILL.md)

### claude-code-slash-commands

**Covers:**
- Command syntax and frontmatter options
- Argument patterns ($ARGUMENTS, $1, $2...)
- Bash integration with ! prefix
- File references with @ prefix
- Complete examples and patterns

[View Details](./skills/claude-code-slash-commands/SKILL.md)

### claude-code-hooks

**Covers:**
- All hook types (SessionStart, PreToolUse, PostToolUse, etc.)
- Matcher patterns for tool filtering
- Exit codes and control flow
- Environment variables
- Complete working examples

[View Details](./skills/claude-code-hooks/SKILL.md)

### claude-code-subagents

**Covers:**
- Common problems and solutions
- System prompt optimization
- Tool access strategies
- Model selection guide
- Testing and validation
- Migration from ad-hoc prompts

[View Details](./skills/claude-code-subagents/SKILL.md)

### claude-code-memory

**Covers:**
- Memory hierarchy (project/user/subfolder)
- Token management and optimization
- Import system (@path/to/file)
- Team collaboration patterns
- Troubleshooting loading issues
- Template examples

[View Details](./skills/claude-code-memory/SKILL.md)

## Best Practices

### Initial Setup
1. Use built-in commands first:
   - `/init` for memory setup
   - `/agents` for subagent creation
2. Use these skills to refine and optimize afterward

### Progressive Learning
Start with one skill at a time:
1. Begin with **memory** - establish good context management
2. Add **slash commands** for common workflows
3. Implement **hooks** for automation
4. Create **subagents** for specialized tasks
5. Package everything in **plugins** for reusability

### Team Collaboration
- Share this plugin with your team for consistent workflows
- Use memory files for team standards
- Create project-specific slash commands
- Document subagent usage patterns

## Troubleshooting

**Skills not activating?**
- Verify plugin is installed: `/plugin list`
- Check descriptions match your use case
- Try explicit skill references in prompts

**Need help with specific features?**
- Memory issues → Use claude-code-memory skill
- Subagent problems → Use claude-code-subagents skill
- Hook debugging → Use claude-code-hooks skill

## Version History

### 1.0.0 (Initial Release)
- claude-code-plugins skill
- claude-code-slash-commands skill
- claude-code-hooks skill
- claude-code-subagents skill
- claude-code-memory skill

## Contributing

Found an issue or have improvements? See the main marketplace [CONTRIBUTING.md](../CONTRIBUTING.md).

## License

See main marketplace repository for license information.

---

**Remember**: These skills are for refinement and troubleshooting. Use Claude Code's built-in commands (`/init`, `/agents`, `/memory`) for initial setup, then use these skills to optimize.