nicholyx/ai-skills / .agents/skills/plugin-creator
plugin-creator
VerifiedComprehensive plugin development skill for Claude Code. Analyzes business requirements and creates complete plugins including MCP servers, skills, slash commands, or combinations thereof. Supports TypeScript, Python, and any other language. Provides architecture guidance, templates, and end-to-end implementation.
README.md
View on GitHub# Plugin Creator Skill
Comprehensive skill for creating production-ready Claude Code plugins.
## Overview
This skill transforms business requirements into fully-functional Claude Code plugins by:
- Analyzing business problems and technical requirements
- Recommending optimal plugin architecture
- Providing templates and implementation guidance
- Creating complete, tested, and packaged plugins
## Features
### Business Analysis
- Systematic requirements discovery
- Architecture recommendation engine
- Component selection guidance
- Integration pattern suggestions
### Component Templates
- **MCP Servers**: TypeScript and Python templates
- **Skills**: Complete skill structure with examples
- **Slash Commands**: Command templates with best practices
- **Full Plugins**: Integrated multi-component templates
### Development Tools
- **init_plugin.py** - Initialize new plugins from templates
- **validate_plugin.py** - Validate plugin structure and quality
- **package_plugin.py** - Package plugins for distribution
### Comprehensive Documentation
- MCP server development guide
- Skill creation guide
- Slash command development guide
- Best practices compendium
- Architecture patterns catalog
## Installation
1. **Copy skill to Claude Code skills directory:**
```bash
cp -r plugin-creator/ ~/.claude/skills/
```
2. **Verify installation:**
- The skill should appear in Claude Code's available skills
- Trigger with plugin creation requests
## Usage
### Quick Start
**Simple request:**
```
"Create a plugin for database schema management"
```
**The skill will:**
1. Analyze your requirements
2. Recommend plugin architecture (e.g., MCP + Skill + Commands)
3. Initialize plugin structure
4. Guide implementation for each component
5. Help with testing and packaging
### Using Helper Scripts
**Initialize a new plugin:**
```bash
# Create TypeScript MCP server
python scripts/init_plugin.py my-api-client --type mcp-ts
# Create skill
python scripts/init_plugin.py code-review --type skill
# Create full plugin
python scripts/init_plugin.py database-toolkit --type full
```
**Validate plugin:**
```bash
python scripts/validate_plugin.py my-plugin/
```
**Package plugin:**
```bash
python scripts/package_plugin.py my-plugin/ --output dist/
```
### Component Selection
The skill recommends components based on your needs:
| Need | Recommended Components |
|------|----------------------|
| External API integration | MCP Server |
| Best practices guide | Skill |
| Quick user shortcuts | Slash Commands |
| Complete solution | Full Plugin (MCP + Skill + Commands) |
## Skill Contents
### SKILL.md
Main skill definition with:
- Business requirements analysis workflow
- Architecture recommendation logic
- Implementation guidance for all components
- Integration patterns
- Testing and packaging procedures
### references/
Comprehensive guides:
- **mcp_server_guide.md** - MCP server development (TypeScript & Python)
- **skill_guide.md** - Skill creation and best practices
- **slash_command_guide.md** - Slash command development
- **best_practices.md** - Plugin development best practices
- **architecture_patterns.md** - Common plugin architectures
### assets/templates/
Production-ready templates:
- **mcp-server-typescript/** - TypeScript MCP server template
- **mcp-server-python/** - Python/FastMCP server template
- **skill/** - Skill template with examples
- **slash-command/** - Slash command template
- **full-plugin/** - Complete plugin template
### scripts/
Development automation:
- **init_plugin.py** - Plugin initialization
- **validate_plugin.py** - Plugin validation
- **package_plugin.py** - Plugin packaging
## Examples
### Example 1: API Testing Plugin
**Request:**
```
"Create a plugin for testing REST APIs"
```
**Skill Analysis:**
- Problem: Developers need efficient API testing
- Operations: Send requests, validate responses, manage test suites
- Tools: HTTP client, validation tools
- Interaction: Commands for quick tests, skill for strategies
**Recommended Architecture:**
```
MCP Server (TypeScript):
- send_request, validate_response, run_test_suite
Skill:
- API testing best practices
- Test strategy guidance
- References: api_schema.md, test_patterns.md
Slash Commands:
- /api:test <endpoint>
- /api:validate <response>
- /api:suite <suite-name>
```
### Example 2: Deployment Plugin
**Request:**
```
"Create a plugin for application deployment"
```
**Skill Analysis:**
- Problem: Need standardized deployment workflows
- Operations: Build, test, deploy, verify
- Tools: CI/CD integrations
- Interaction: Workflows with safety checks
**Recommended Architecture:**
```
MCP Server (Python):
- build_image, deploy_service, health_check
Skill:
- Deployment checklists
- Rollback procedures
- References: environments.md, safety_checklist.md
Slash Commands:
- /deploy:dev
- /deploy:staging
- /deploy:prod --confirm
- /rollback
```
## Architecture Patterns
### Single Component
- Pure MCP Server - API wrapper, database connector
- Pure Skill - Best practices, workflows
- Pure Commands - Simple shortcuts
### Multi-Component
- MCP + Skill - Tools + knowledge
- MCP + Commands - Tools + shortcuts
- Skill + Commands - Workflows + shortcuts
- Full Plugin - Complete solution
## Best Practices
### Requirements Analysis
- Ask clarifying questions
- Identify core operations
- Determine integration needs
- Assess complexity level
### Component Selection
- Match components to needs
- Avoid over-engineering
- Consider maintainability
- Plan for extensibility
### Implementation
- Start with templates
- Follow coding standards
- Validate early and often
- Test thoroughly
- Document comprehensively
### Distribution
- Validate before packaging
- Write clear installation instructions
- Include usage examples
- Provide support information
## Troubleshooting
### Template Issues
**Problem:** Template not found
**Solution:** Verify skill installation, check assets/templates/ directory exists
**Problem:** Template initialization fails
**Solution:** Ensure output directory is writable, check for naming conflicts
### Validation Issues
**Problem:** Validation fails with errors
**Solution:** Read error messages carefully, fix issues one by one, re-run validation
**Problem:** Too many warnings
**Solution:** Warnings are ok for packaging, but address them for quality
### Packaging Issues
**Problem:** Package too large
**Solution:** Ensure node_modules and build artifacts are excluded (automatic)
**Problem:** Package validation fails
**Solution:** Run validate_plugin.py standalone, fix errors, retry packaging
## Advanced Usage
### Custom Templates
Create custom templates in `assets/templates/`:
1. Add new template directory
2. Create template files
3. Update init_plugin.py with new type
4. Test template initialization
### Plugin Extensions
Extend existing plugins:
1. Analyze existing plugin architecture
2. Identify extension points
3. Create complementary components
4. Document integration patterns
### Plugin Suites
Create related plugin collections:
1. Design plugin ecosystem
2. Define shared infrastructure
3. Create individual plugins
4. Document integration
## Resources
### Documentation
- [MCP Specification](https://modelcontextprotocol.io)
- [FastMCP](https://github.com/jlowin/fastmcp)
- [Claude Code Docs](https://docs.claude.com/claude-code)
### Community
- Share your plugins
- Contribute improvements
- Request features
- Report issues
## License
MIT License - Feel free to use and modify for your needs.
## Contributing
Contributions welcome:
- Template improvements
- New architecture patterns
- Documentation enhancements
- Bug fixes
## Support
For issues and questions:
1. Check documentation in references/
2. Review examples
3. Consult best practices
4. Ask Claude Code community
---
**Version:** 1.0.0
**Created with:** Claude Code Plugin Creator
**Status:** Production Ready
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |