Convert Nelson to a Claude Code plugin

.claude-plugin/marketplace.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "nelson-marketplace",
+  "description": "Royal Navy agent coordination framework for Claude Code",
+  "owner": {
+    "name": "Harry Munro"
+  },
+  "plugins": [
+    {
+      "name": "nelson",
+      "description": "Royal Navy agent coordination framework — sailing orders, battle plans, action stations, and a captain's log",
+      "version": "1.0.0",
+      "author": { "name": "Harry Munro" },
+      "source": "./",
+      "repository": "https://github.com/harrymunro/nelson",
+      "license": "MIT",
+      "keywords": ["agents", "coordination", "teams", "workflow"],
+      "category": "workflow"
+    }
+  ]
+}

.claude-plugin/plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "nelson",
+  "description": "Royal Navy agent coordination framework — sailing orders, battle plans, action stations, and a captain's log",
+  "version": "1.0.0",
+  "author": { "name": "Harry Munro" },
+  "repository": "https://github.com/harrymunro/nelson",
+  "license": "MIT",
+  "keywords": ["agents", "coordination", "teams", "workflow"],
+  "skills": "./skills/",
+  "agents": "./agents/"
+}

.gitignore

@@ -3,3 +3,4 @@
 __pycache__/
 *.pyc
 .DS_Store
+.claude/skills/nelson

CLAUDE.md

@@ -5,20 +5,23 @@ Nelson is a Claude Code skill for coordinating agent work using Royal Navy termi
 ## Project structure
 
 ```
-.claude/skills/nelson/
-  SKILL.md              — Main entrypoint (what Claude reads)
-  references/           — Supporting docs loaded on demand
-    action-stations.md    — Risk tier definitions (Station 0–3)
-    admiralty-templates.md — Index routing to individual template files
-    admiralty-templates/   — One file per template, loaded on demand
-    crew-roles.md         — Crew role definitions, ship names & sizing rules
-    damage-control.md     — Index routing to individual procedure files
-    damage-control/       — One file per procedure, loaded on demand
+.claude-plugin/
+  plugin.json             — Plugin manifest
+  marketplace.json        — Marketplace definition (self-hosted)
+skills/nelson/
+  SKILL.md                — Main entrypoint (what Claude reads)
+  references/             — Supporting docs loaded on demand
+    action-stations.md      — Risk tier definitions (Station 0–3)
+    admiralty-templates.md   — Index routing to individual template files
+    admiralty-templates/     — One file per template, loaded on demand
+    crew-roles.md           — Crew role definitions, ship names & sizing rules
+    damage-control.md       — Index routing to individual procedure files
+    damage-control/         — One file per procedure, loaded on demand
     squadron-composition.md — Mode selection & team sizing rules
-    standing-orders.md    — Index routing to individual anti-pattern files
-    standing-orders/      — One file per anti-pattern, loaded on demand
-  agents/               — Agent interface definitions
-demos/                  — Example applications built with Nelson
+    standing-orders.md      — Index routing to individual anti-pattern files
+    standing-orders/        — One file per anti-pattern, loaded on demand
+agents/                   — Agent interface definitions
+demos/                    — Example applications built with Nelson
 ```
 
 ## No build system
@@ -27,12 +30,20 @@ This is a documentation-driven skill with zero runtime dependencies. There is no
 
 ## Testing changes
 
-Install the skill locally and run a mission to verify. Either tell Claude Code "Install skills from https://github.com/harrymunro/nelson" or copy the skill directory manually:
+Install the plugin and run a mission to verify:
 
-```bash
-mkdir -p <target-project>/.claude/skills
-cp -r .claude/skills/nelson <target-project>/.claude/skills/nelson
 ```
+/plugin install harrymunro/nelson
+```
+
+Or add the marketplace first, then install:
+
+```
+/plugin marketplace add harrymunro/nelson
+/plugin install nelson
+```
+
+For local development in this repo, the symlink at `.claude/skills/nelson` → `../../skills/nelson` means `/nelson` works automatically.
 
 Then invoke `/nelson` in Claude Code.
 

README.md

@@ -38,7 +38,20 @@ Nelson gives Claude a six-step operational framework for tackling complex missio
 
 ## Installation
 
-### Prompt-based (recommended)
+### Plugin install (recommended)
+
+```
+/plugin install harrymunro/nelson
+```
+
+Or add the marketplace first, then install by name:
+
+```
+/plugin marketplace add harrymunro/nelson
+/plugin install nelson
+```
+
+### Prompt-based
 
 Open Claude Code and say:
 
@@ -56,11 +69,11 @@ Clone the repo and copy the skill directory yourself:
 # Project-level (recommended for teams)
 git clone https://github.com/harrymunro/nelson.git /tmp/nelson
 mkdir -p .claude/skills
-cp -r /tmp/nelson/.claude/skills/nelson .claude/skills/nelson
+cp -r /tmp/nelson/skills/nelson .claude/skills/nelson
 rm -rf /tmp/nelson
 
 # Or user-level (personal, all projects)
-cp -r /tmp/nelson/.claude/skills/nelson ~/.claude/skills/nelson
+cp -r /tmp/nelson/skills/nelson ~/.claude/skills/nelson
 ```
 
 Then commit `.claude/skills/nelson/` to version control so your team can use it.
@@ -218,13 +231,14 @@ The skill includes structured templates for consistent output across missions:
 
 <img width="1024" height="559" alt="image" src="https://github.com/user-attachments/assets/5955341c-a251-4e05-b0ed-61f424181201" />
 
-## Skill file structure
+## Plugin file structure
 
 ```
-.claude/skills/nelson/
+.claude-plugin/
+├── plugin.json                               # Plugin manifest
+└── marketplace.json                          # Marketplace definition (self-hosted)
+skills/nelson/
 ├── SKILL.md                                  # Main skill instructions (entrypoint)
-├── agents/
-│   └── openai.yaml                           # OpenAI agent interface definition
 └── references/
     ├── action-stations.md                    # Risk tier definitions and controls
     ├── admiralty-templates.md                # Template routing index
@@ -258,8 +272,12 @@ The skill includes structured templates for consistent output across missions:
         ├── skeleton-crew.md
         ├── split-keel.md
         └── unclassified-engagement.md
+agents/
+└── openai.yaml                              # OpenAI agent interface definition
 ```
 
+- `plugin.json` declares the plugin name, version, and component paths for Claude Code's plugin system.
+- `marketplace.json` lets users add this repo as a plugin marketplace and install Nelson by name.
 - `SKILL.md` is the entrypoint that Claude reads when the skill is invoked. It defines the six-step workflow and references the supporting files.
 - Files in `references/` contain detailed guidance that Claude loads on demand — they are not all loaded into context at once.
 

scripts/check-references.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-SKILL_DIR=".claude/skills/nelson"
+SKILL_DIR="skills/nelson"
 REF_DIR="$SKILL_DIR/references"
 errors=0