tools-only Interactive Learning Lab
Learn Claude Code plugin development through hands-on Jupyter notebooks
📚 11 interactive tutorials | 🎯 Beginner → Advanced | ⏱️ ~5 hours total
🚀 Quick Start
- Install Jupyter:
pip install jupyter nbformat - Choose your path: Beginner? Start with Skills. Advanced? Jump to MCP.
- Open a notebook:
jupyter notebook tutorials/skills/01-what-is-skill.ipynb - Run cells: Execute code interactively and learn by doing
📖 Learning Paths
Path 1: Plugin Creator (Beginner → Intermediate)
Goal: Create and publish your first Claude Code plugin
- What is SKILL.md? - 20 min
- Skill Anatomy - 25 min
- Build Your First Skill - 45 min
- What is a Plugin? - 25 min
- Plugin Structure - 30 min
- Build Your First Plugin - 45 min
Time: ~3 hours | Output: Production-ready plugin
Path 2: Advanced Developer (Intermediate → Advanced)
Goal: Master advanced patterns and MCP servers
- Advanced Skill Patterns - 45 min
- Skill Validation - 30 min
- MCP Server Plugins - 60 min
- Mental Model - 30 min
- Orchestration Pattern - 45 min
Time: ~3.5 hours | Output: TypeScript MCP server, multi-agent orchestration
Path 3: Quick Reference (Just-in-Time Learning)
Goal: Find specific answers fast
| Need | Tutorial | Time |
|---|---|---|
| Understand SKILL.md basics | 01-what-is-skill | 20 min |
| Fix validation errors | 05-skill-validation | 30 min |
| Build instruction plugin | 03-build-your-first-plugin | 45 min |
| Build MCP plugin | 04-mcp-server-plugins | 60 min |
| Multi-agent patterns | 02-orchestration-pattern | 45 min |
📚 Tutorial Catalog
Skills Tutorials (5 notebooks)
Build skills that teach Claude new workflows.
Total: 165 minutes (2h 45m) | Cells: 77 interactive
Plugins Tutorials (4 notebooks)
Package skills into shareable, versioned plugins.
| # | Title | Level | Time | Colab |
|---|---|---|---|---|
| 01 | What is a Plugin? | Beginner | 25 min | |
| 02 | Plugin Structure | Intermediate | 30 min | |
| 03 | Build Your First Plugin | Intermediate | 45 min | |
| 04 | MCP Server Plugins | Advanced | 60 min |
Total: 160 minutes (2h 40m) | Cells: 40 interactive
Orchestration Tutorials (2 notebooks)
Master multi-agent coordination and complex workflows.
| # | Title | Level | Time | Colab |
|---|---|---|---|---|
| 01 | Mental Model | Intermediate | 30 min | |
| 02 | Orchestration Pattern | Advanced | 45 min |
Total: 75 minutes (1h 15m) | Cells: 37 interactive
🎯 By Role
I'm a Developer
You want: Build plugins for your team
Start here:
- Build Your First Skill
- Build Your First Plugin
- Skill Validation
I'm a Power User
You want: Automate workflows without coding
Start here:
- What is SKILL.md?
- Skill Anatomy
- Build Your First Skill
I'm an Enterprise Architect
You want: Understand standards and governance
Start here:
- Skill Validation - Enterprise standards (6767-c)
- Plugin Structure - Validation and security
- Advanced Skill Patterns - Production patterns
I'm a TypeScript Developer
You want: Build MCP servers with external integrations
Start here:
- What is a Plugin? - Understand plugin types
- MCP Server Plugins - Full TypeScript implementation
- Orchestration Pattern - Multi-agent coordination
🏆 Learning Outcomes
After completing all tutorials, you will:
✅ Understand SKILL.md format and Claude's discovery system ✅ Create enterprise-compliant skills following 6767-c standards ✅ Build complete plugins with skills, commands, and documentation ✅ Validate using automated tools and CI/CD pipelines ✅ Implement TypeScript MCP servers with external integrations ✅ Orchestrate multi-agent workflows for complex tasks ✅ Publish to marketplaces or share with your team
📊 Quick Stats
| Metric | Value |
|---|---|
| Total Tutorials | 11 notebooks |
| Interactive Cells | 154 code cells |
| Learning Time | ~6 hours |
| Difficulty Range | Beginner → Advanced |
| Standards Compliance | 6767-c (Enterprise) |
| Languages | Python, TypeScript, Markdown |
🛠️ Prerequisites
Required
- Jupyter:
pip install jupyter nbformat - Python 3.9+: For running notebooks
- Text editor: VS Code, Vim, etc.
Optional (for MCP tutorials)
- Node.js 20+: For TypeScript MCP servers
- TypeScript:
npm install -g typescript - Claude Code CLI: To test plugins
🚦 Getting Started
Option 1: Run Locally
# Clone repository
git clone https://github.com/jeremylongshore/claude-code-plugins.git
cd claude-code-plugins/tutorials
# Install Jupyter
pip install jupyter nbformat
# Start Jupyter
jupyter notebook
Option 2: Google Colab (Coming Soon)
Click the "Open in Colab" badge on any notebook to run in the cloud (no installation required).
📝 Tutorial Format
All tutorials follow this structure:
- Learning Goals - What you'll accomplish
- Prerequisites - What to know first
- Concepts - Theory with examples
- Interactive Code - Run and modify cells
- Hands-On Project - Build something real
- Validation - Check your work
- Next Steps - Where to go next
🎓 Best Practices
How to Use These Tutorials
- Run cells in order - Each cell builds on previous ones
- Modify and experiment - Change values, try different inputs
- Read error messages - They teach you validation rules
- Save your work - Use File → Download to keep your changes
- Ask questions - Comments and issues welcome
Learning Tips
- ✅ Do the exercises - Don't just read, actually build
- ✅ Start simple - Beginner tutorials first, even if experienced
- ✅ Validate early - Run validators to catch mistakes fast
- ✅ Study examples - Real marketplace plugins are best teachers
- ✅ Share your work - Publish plugins to get feedback
🔗 Additional Resources
Documentation
Examples
Community
- GitHub Issues
- Discussions
- Contributing Guide
🤝 Contributing
Found a typo? Have a suggestion? Want to add a tutorial?
- Report issues: GitHub Issues
- Suggest tutorials: Discussions
- Submit PRs: Fork, create branch, submit pull request
📜 License
All tutorials are licensed under MIT License - feel free to use, modify, and share.
🙏 Acknowledgments
Created by the Claude Code Plugins community. Special thanks to all contributors who made these tutorials possible.
Ready to start learning? Pick a path above and dive in! 🚀