You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Every exercise in this guide teaches one layer of Claude Code's extensibility system -- from configuring settings through building and distributing plugins to running autonomous iteration loops. These aren't abstract concepts. They are working configurations you build, test, and debug on real scenarios.
11
+
This guide contains 12 core exercises across 6 modules plus 3 capstone projects (15 total). Each exercise teaches one layer of Claude Code's extensibility system -- from configuring settings through building and distributing plugins to running autonomous iteration loops. These aren't abstract concepts. They are working configurations you build, test, and debug on real scenarios.
12
12
13
13
**The exercise pattern:**
14
14
15
-
Each module covers one extensibility layer with two exercises. Exercise X.1 is **Hands-on** -- you build or configure something real. Exercise X.2 is **Debug/Diagnose** -- you fix a broken configuration, audit a problematic setup, or analyze a failure.
15
+
Each module covers one extensibility layer with two exercises. Exercise X.1 is **Hands-on** -- you build or configure something real. Exercise X.2 is **Debug/Diagnose** -- you fix a broken configuration, audit a problematic setup, or analyze a failure. Marketplace distribution is integrated into the Capstone A project rather than being a standalone module.
16
16
17
17
**The three skills you'll develop:**
18
18
@@ -267,7 +267,7 @@ Packaging is just organization plus a manifest. The skills themselves don't chan
267
267
268
268
---
269
269
270
-
### Exercise 5.2 -- Full Plugin Bundle
270
+
### Exercise 5.2 -- Full Plugin Bundle (Advanced)
271
271
272
272
**The Problem:**
273
273
A complete "Team Productivity" plugin needs skills, hooks, and an MCP server configuration bundled together. This is the full plugin packaging exercise -- everything you've learned about skills, hooks, and plugins combined into one distributable package.
@@ -290,57 +290,6 @@ A complete "Team Productivity" plugin needs skills, hooks, and an MCP server con
290
290
291
291
---
292
292
293
-
## Module 6: Marketplace Distribution
294
-
295
-
> **Core Skill:** Create plugin marketplaces and distribute plugins to teams and the community.
296
-
297
-
### Exercise 6.1 -- Create Marketplace
298
-
299
-
**The Problem:**
300
-
You have two plugins ready to share with your team, but they need a marketplace to discover and install them easily. You need to create a marketplace listing, organize the directory structure, and configure it as a marketplace source.
301
-
302
-
**Your Task:**
303
-
304
-
1. Create the marketplace directory structure
305
-
2. Write a `marketplace.json` listing the two provided plugins
306
-
3. Add the plugins to the marketplace directory
307
-
4. Configure the marketplace as a source using `/plugin marketplace add`
308
-
5. Verify plugins appear in the Discover tab
309
-
310
-
**The Principle at Work:**
311
-
A marketplace is just a catalog -- a `marketplace.json` file that points to plugin directories. The infrastructure is simple; the value is in organization and discoverability.
312
-
313
-
**What You'll Learn:**
314
-
315
-
- The `marketplace.json` format and required fields
316
-
- How marketplace sources work (local, GitHub, GitLab)
317
-
- The relationship between plugins and marketplaces (apps vs. app store)
318
-
- How to test marketplace listings locally before publishing
319
-
320
-
---
321
-
322
-
### Exercise 6.2 -- Cross-Marketplace
323
-
324
-
**The Problem:**
325
-
You're evaluating plugins from three different marketplace sources (official Anthropic, a community marketplace, and a company-internal marketplace). Each has plugins that partially overlap. You need to compare them and recommend the best plugin for a specific need.
326
-
327
-
**Your Task:**
328
-
329
-
1. Review the three marketplace listings provided
330
-
2. Compare overlapping plugins across marketplaces
331
-
3. Evaluate each based on: feature fit, maintenance quality, scope, and trust level
332
-
4. Write a recommendation document with your analysis
333
-
5. Create a "marketplace evaluation framework" for future decisions
334
-
335
-
**What You'll Learn:**
336
-
337
-
- How to evaluate plugin quality across different sources
338
-
- Trust considerations: official vs. community vs. internal marketplaces
339
-
- Feature overlap resolution: when two plugins solve the same problem
340
-
- Documentation standards for plugin recommendations
341
-
342
-
---
343
-
344
293
## Module 7: Ralph Wiggum Loop
345
294
346
295
> **Core Skill:** Design and execute autonomous iteration loops with proper completion promises, safety guardrails, and cost awareness.
@@ -401,23 +350,24 @@ An activity log from a Ralph Wiggum Loop that ran for 12 iterations without comp
401
350
### Capstone A -- Full Plugin from Scratch
402
351
403
352
**The Problem:**
404
-
Build a complete "Code Review" plugin that includes skills for review patterns, hooks for automated checks, and documentation for team adoption. Package it, test it, and create a marketplace entry.
353
+
Build a complete "Code Review" plugin that includes skills for review patterns, hooks for automated checks, and documentation for team adoption. Package it, test it, create a marketplace entry, and distribute it.
405
354
406
355
**Your Task:**
407
356
408
357
1. Design the plugin: define skills, hooks, and configurations needed
409
358
2. Create each component: skills for review checklists, hooks for pre-commit checks
410
359
3. Write the plugin manifest (`plugin.json`)
411
-
4.Create marketplace entry (`marketplace.json`)
412
-
5.Test the complete plugin locally with `--plugin-dir`
413
-
6.Write user documentation explaining how to install and use the plugin
360
+
4.Test the complete plugin locally with `--plugin-dir`
361
+
5.Write user documentation explaining how to install and use the plugin
362
+
6.Create a marketplace listing and distribute the plugin
414
363
415
364
**Deliverables:**
416
365
417
366
- Working plugin directory with all components
418
367
- Plugin manifest and marketplace listing
419
368
- User documentation (README.md inside the plugin)
420
369
- Test results showing all components work together
370
+
- Marketplace entry with installation instructions
421
371
422
372
**Estimated Time:** 2-4 hours
423
373
@@ -477,15 +427,14 @@ Audit your own Claude Code workflow and identify what's missing from your extens
| Settings Understanding | Uses only defaults | Configured one level | Manages all 3 levels with correct precedence | Designs team-wide configuration strategies |
483
-
| Hook Implementation | Cannot create hooks | Basic hooks, no error handling | Multi-event hooks with matchers and exit codes | Production hooks with logging and testing |
484
-
| Plugin Evaluation | Cannot navigate marketplace | Browses marketplace | Evaluates fit systematically | Creates evaluation frameworks for teams |
485
-
| Plugin Creation | Cannot create manifest | Basic manifest with skills | Full bundle with hooks + MCP | Production plugins with docs and tests |
486
-
| Marketplace Competence | Unaware of marketplace concept | Uses official marketplace | Creates personal marketplaces | Multi-source marketplace strategy |
487
-
| Autonomous Iteration | Never used Ralph Loop | Basic loop, poor completion promise | Effective promises with safety limits | Complex loops with cost management |
488
-
| Integration Thinking | Components in isolation | Combines 2 components | Full extensibility stack | Team-wide extensibility architecture |
| Settings Understanding | Uses only defaults | Configured one level | Manages all 3 levels with correct precedence | Designs team-wide configuration strategies |
433
+
| Hook Implementation | Cannot create hooks | Basic hooks, no error handling | Multi-event hooks with matchers and exit codes | Production hooks with logging and testing |
434
+
| Plugin Evaluation | Cannot navigate marketplace | Browses marketplace | Evaluates fit systematically | Creates evaluation frameworks for teams |
435
+
| Plugin Creation | Cannot create manifest | Basic manifest with skills | Full bundle with hooks + MCP | Production plugins with docs, tests, and marketplace distribution |
436
+
| Autonomous Iteration | Never used Ralph Loop | Basic loop, poor completion promise | Effective promises with safety limits | Complex loops with cost management |
437
+
| Integration Thinking | Components in isolation | Combines 2 components | Full extensibility stack | Team-wide extensibility architecture |
Copy file name to clipboardExpand all lines: README.md
+13-18Lines changed: 13 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
3
3
**By Panaversity -- Master the Full Plugin Lifecycle**
4
4
5
-
Welcome! This package contains 14 exercises + 3 capstone projects covering Claude Code's extensibility system -- from settings hierarchy and hooks through plugin creation, marketplace distribution, and autonomous iteration with Ralph Wiggum Loop. You'll configure real settings, write working hooks, build plugins from scratch, and run autonomous loops.
5
+
Welcome! This package contains 12 exercises + 3 capstone projects (15 total) covering Claude Code's extensibility system -- from settings hierarchy and hooks through plugin creationand autonomous iteration with Ralph Wiggum Loop. You'll configure real settings, write working hooks, build plugins from scratch, distribute them via marketplaces (in Capstone A), and run autonomous loops.
6
6
7
7
---
8
8
@@ -26,15 +26,12 @@ plugins-exercises/
26
26
| +-- exercise-4.2-plugin-workflow-chain/ (chain plugins for a complete workflow)
27
27
+-- module-5-plugin-packaging/
28
28
| +-- exercise-5.1-package-skills-plugin/ (package skills into a plugin)
29
-
| +-- exercise-5.2-full-plugin-bundle/ (build a complete plugin bundle)
30
-
+-- module-6-marketplace-distribution/
31
-
| +-- exercise-6.1-create-marketplace/ (create a marketplace listing)
32
-
| +-- exercise-6.2-cross-marketplace/ (evaluate and compare marketplaces)
29
+
| +-- exercise-5.2-full-plugin-bundle/ (build a complete plugin bundle -- Advanced)
33
30
+-- module-7-ralph-wiggum/
34
31
| +-- exercise-7.1-autonomous-loop/ (run your first Ralph Wiggum loop)
35
32
| +-- exercise-7.2-stuck-loop-debug/ (diagnose a stuck loop from logs)
36
33
+-- module-8-capstones/
37
-
+-- capstone-A-full-plugin/ (build a complete plugin from scratch)
34
+
+-- capstone-A-full-plugin/ (build a complete plugin + marketplace distribution)
38
35
+-- capstone-B-team-extensibility-kit/ (design extensibility for a team)
39
36
+-- capstone-C-your-workflow/ (audit and extend your own workflow)
| Settings Understanding | Uses only default settings | Configured one level | Manages all 3 levels with precedence | Designs team-wide configuration strategies |
90
+
| Hook Design | Cannot create hooks | Basic single-event hooks | Multi-event hooks with matchers | Hook systems with error handling and logging |
91
+
| Plugin Usage | Cannot install plugins | Installs and uses basic plugins | Evaluates plugin fit for workflows | Chains plugins for complex workflows |
92
+
| Plugin Creation | Cannot create plugins | Basic manifest with skills only | Full plugin bundle with hooks + MCP | Production plugins with docs, tests, and marketplace distribution |
93
+
| Autonomous Iteration | Never used Ralph Loop | Basic loop with simple task | Effective completion promises + safety | Complex multi-stage loops with cost management |
94
+
| Integration Thinking | Components used in isolation | Combines 2 components | Full extensibility stack configured | Team-wide extensibility architecture |
Copy file name to clipboardExpand all lines: module-3-plugin-discovery/exercise-3.1-marketplace-explorer/INSTRUCTIONS.md
+2Lines changed: 2 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,6 +13,8 @@ Learn to survey the Claude Code plugin marketplace and make informed decisions a
13
13
14
14
## Your Tasks
15
15
16
+
> **Note**: The plugin marketplace evolves over time. If no plugin matches a workflow need, that's a valid finding — recommend "Build Custom" and describe what you'd create. The evaluation PROCESS matters more than finding a perfect match.
17
+
16
18
### Step 1: Review the Workflow Needs
17
19
18
20
Read `workflow-needs.md` carefully. Each need describes a concrete workflow problem that might be solved by an existing plugin.
Copy file name to clipboardExpand all lines: module-4-plugin-usage/exercise-4.1-install-and-use/INSTRUCTIONS.md
+2Lines changed: 2 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,6 +12,8 @@ Install a plugin from the official marketplace and use it on a real project. Exp
12
12
13
13
## Your Tasks
14
14
15
+
> **Prerequisites check**: Run `npm --version` to verify Node.js is installed. If installing an LSP plugin, ensure the language server binary is available (e.g., `typescript-language-server --version`). If LSP installation fails, complete the exercise using only `commit-commands` — the core learning is the install-configure-verify cycle, not the specific plugin.
Copy file name to clipboardExpand all lines: module-6-marketplace-distribution/exercise-6.1-create-marketplace/plugins/code-quality/.claude-plugin/plugin.json
Copy file name to clipboardExpand all lines: module-6-marketplace-distribution/exercise-6.1-create-marketplace/plugins/code-quality/skills/lint-check/SKILL.md
Copy file name to clipboardExpand all lines: module-6-marketplace-distribution/exercise-6.1-create-marketplace/plugins/productivity/.claude-plugin/plugin.json
Copy file name to clipboardExpand all lines: module-6-marketplace-distribution/exercise-6.1-create-marketplace/plugins/productivity/skills/daily-standup/SKILL.md
0 commit comments