Skip to content

Latest commit

 

History

History
286 lines (194 loc) · 11.5 KB

File metadata and controls

286 lines (194 loc) · 11.5 KB

Interactive Learning Lab

Learn Claude Code plugin development through hands-on Jupyter notebooks

📚 11 interactive tutorials | 🎯 Beginner → Advanced | ⏱️ ~5 hours total


🚀 Quick Start

  1. Install Jupyter: pip install jupyter nbformat
  2. Choose your path: Beginner? Start with Skills. Advanced? Jump to MCP.
  3. Open a notebook: jupyter notebook tutorials/skills/01-what-is-skill.ipynb
  4. 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

  1. What is SKILL.md? - 20 min
  2. Skill Anatomy - 25 min
  3. Build Your First Skill - 45 min
  4. What is a Plugin? - 25 min
  5. Plugin Structure - 30 min
  6. 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

  1. Advanced Skill Patterns - 45 min
  2. Skill Validation - 30 min
  3. MCP Server Plugins - 60 min
  4. Mental Model - 30 min
  5. 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.

# Title Level Time Colab
01 What is SKILL.md? Beginner 20 min Open In Colab
02 Skill Anatomy Beginner 25 min Open In Colab
03 Build Your First Skill Intermediate 45 min Open In Colab
04 Advanced Skill Patterns Advanced 45 min Open In Colab
05 Skill Validation Intermediate 30 min Open In Colab

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 Open In Colab
02 Plugin Structure Intermediate 30 min Open In Colab
03 Build Your First Plugin Intermediate 45 min Open In Colab
04 MCP Server Plugins Advanced 60 min Open In Colab

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 Open In Colab
02 Orchestration Pattern Advanced 45 min Open In Colab

Total: 75 minutes (1h 15m) | Cells: 37 interactive


🎯 By Role

I'm a Developer

You want: Build plugins for your team

Start here:

  1. Build Your First Skill
  2. Build Your First Plugin
  3. Skill Validation

I'm a Power User

You want: Automate workflows without coding

Start here:

  1. What is SKILL.md?
  2. Skill Anatomy
  3. Build Your First Skill

I'm an Enterprise Architect

You want: Understand standards and governance

Start here:

  1. Skill Validation - Enterprise standards (6767-c)
  2. Plugin Structure - Validation and security
  3. Advanced Skill Patterns - Production patterns

I'm a TypeScript Developer

You want: Build MCP servers with external integrations

Start here:

  1. What is a Plugin? - Understand plugin types
  2. MCP Server Plugins - Full TypeScript implementation
  3. 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:

  1. Learning Goals - What you'll accomplish
  2. Prerequisites - What to know first
  3. Concepts - Theory with examples
  4. Interactive Code - Run and modify cells
  5. Hands-On Project - Build something real
  6. Validation - Check your work
  7. Next Steps - Where to go next

🎓 Best Practices

How to Use These Tutorials

  1. Run cells in order - Each cell builds on previous ones
  2. Modify and experiment - Change values, try different inputs
  3. Read error messages - They teach you validation rules
  4. Save your work - Use File → Download to keep your changes
  5. 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


🤝 Contributing

Found a typo? Have a suggestion? Want to add a tutorial?

  1. Report issues: GitHub Issues
  2. Suggest tutorials: Discussions
  3. 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! 🚀