Interactive Learning Lab

May 30, 2026 ยท View on GitHub

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

NeedTutorialTime
Understand SKILL.md basics01-what-is-skill20 min
Fix validation errors05-skill-validation30 min
Build instruction plugin03-build-your-first-plugin45 min
Build MCP plugin04-mcp-server-plugins60 min
Multi-agent patterns02-orchestration-pattern45 min

๐Ÿ“š Tutorial Catalog

Skills Tutorials (5 notebooks)

Build skills that teach Claude new workflows.

#TitleLevelTimeColab
01What is SKILL.md?Beginner20 minOpen In Colab
02Skill AnatomyBeginner25 minOpen In Colab
03Build Your First SkillIntermediate45 minOpen In Colab
04Advanced Skill PatternsAdvanced45 minOpen In Colab
05Skill ValidationIntermediate30 minOpen In Colab

Total: 165 minutes (2h 45m) | Cells: 77 interactive


Plugins Tutorials (4 notebooks)

Package skills into shareable, versioned plugins.

#TitleLevelTimeColab
01What is a Plugin?Beginner25 minOpen In Colab
02Plugin StructureIntermediate30 minOpen In Colab
03Build Your First PluginIntermediate45 minOpen In Colab
04MCP Server PluginsAdvanced60 minOpen In Colab

Total: 160 minutes (2h 40m) | Cells: 40 interactive


Orchestration Tutorials (2 notebooks)

Master multi-agent coordination and complex workflows.

#TitleLevelTimeColab
01Mental ModelIntermediate30 minOpen In Colab
02Orchestration PatternAdvanced45 minOpen 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

MetricValue
Total Tutorials11 notebooks
Interactive Cells154 code cells
Learning Time~6 hours
Difficulty RangeBeginner โ†’ Advanced
Standards Compliance6767-c (Enterprise)
LanguagesPython, 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! ๐Ÿš€