claude-plugin

Personal Claude Plugins Marketplace

[!WARNING] For now this is just a place to try out Claude plugins, not much to see here.

Quick Start

Step 1: Add the Marketplace

Add this marketplace to Claude Code:

/plugin marketplace add geoffjay/claude-plugins

This makes all plugins available for installation, but does not load any agents or tools into the Claude context.

Step 2: Install Plugins

Browse available plugins:

/plugin

Install the plugins you need:

/plugin install golang-development

Each installed plugin only loads its specific agents, commands, and skills into the Claude context.

Architecture Highlights

Granular Design

• Single responsibility - Each plugin does one thing well
• Minimal token usage - Average 3.4 components per plugin
• Composable - Mix and match for complex workflows
• 100% coverage - All 85 agents accessible across plugins

Progressive Disclosure (Skills)

Three-tier architecture for token efficiency:

1. Metadata - Name and activation criteria (always loaded)
2. Instructions - Core guidance (loaded when activated)
3. Resources - Examples and templates (loaded on demand)

Repository Structure

claude-agents/
├── .claude-plugin/
│   └── marketplace.json          # all plugins
├── plugins/
│   ├── golang-development/
│   │   ├── agents/               # Expert definitions
│   │   ├── commands/             # Scaffolding tool
│   │   └── skills/               # Specialized skills
│   └── ... (more plugins)
├── docs/                         # Comprehensive documentation
└── README.md                     # This file

→ View architecture details

Contributing

To add new agents, skills, or commands:

1. Identify or create the appropriate plugin directory in plugins/
2. Create .md files in the appropriate subdirectory:
   • agents/ - For specialized agents
   • commands/ - For tools and workflows
   • skills/ - For modular knowledge packages
3. Follow naming conventions (lowercase, hyphen-separated)
4. Write clear activation criteria and comprehensive content
5. Update the plugin definition in .claude-plugin/marketplace.json

See Architecture Documentation for detailed guidelines.

Resources

Documentation

• Claude Code Documentation
• Plugins Guide
• Subagents Guide
• Agent Skills Guide
• Slash Commands Reference

Attribution

This project borrows considerably from wshobson/agents.

License

MIT License - see LICENSE file for details.