ship-pipeline

claude-code-toolbox

Private Claude Code plugin marketplace — reusable agents, skills, and hooks extracted from real project experience.

Plugins

Name	Purpose	Status
engineering-guardrails	PreToolUse hooks that block code violating load-bearing conventions	v0.1
ship-pipeline	/ship-pr skill running simplify → gates → push → PR → watch → merge	planned
batch-resolve-conflicts	Spawn rebase agents for N conflicting PRs in parallel	planned
phased-rollout-template	Scaffold a new phased-rollout project (CLAUDE.md + ACCOUNTS + DEPLOY + CI)	planned

Install

One-time per device

Clone the toolbox:

git clone [email protected]:<your-gh-user>/claude-code-toolbox.git ~/claude-code-toolbox

Register the marketplace in user-global settings. Edit ~/.claude/settings.json and merge in:

{
  "extraKnownMarketplaces": {
    "toolbox": {
      "source": {
        "source": "directory",
        "path": "~/claude-code-toolbox"
      }
    }
  }
}

(If ~/.claude/settings.json already exists, merge the extraKnownMarketplaces key into the existing object — do not replace the whole file.)

Enable plugins

Per-project, in .claude/settings.local.json (or user-global for all projects, in ~/.claude/settings.json):

{
  "enabledPlugins": {
    "engineering-guardrails@toolbox": true
  }
}

Update

cd ~/claude-code-toolbox && git pull

Plugins are loaded fresh each Claude Code session — restart Claude Code or open /permissions to reload.

Prerequisites

• Claude Code v2.0+ (plugin marketplace support)
• Python 3 on PATH (the hooks invoke python directly)

Adding a new plugin

1. mkdir plugins/<name>/{scripts,skills,agents} as needed
2. Add plugins/<name>/plugin.json (manifest with hooks/skills/etc.)
3. Add plugins/<name>/README.md (what it does, install, examples)
4. Append a plugin entry to .claude-plugin/marketplace.json
5. Commit, push, git pull on every device that needs it

Layout

claude-code-toolbox/
├── .claude-plugin/
│   └── marketplace.json        (lists every plugin in this repo)
├── plugins/
│   └── <name>/
│       ├── plugin.json         (manifest — hooks, skills, agents)
│       ├── README.md           (what it does + how to use)
│       ├── scripts/            (executables invoked by hooks/skills)
│       ├── skills/             (.md skill files — optional)
│       └── agents/             (.md agent definitions — optional)
└── README.md                   (this file)

Privacy

Keep the GitHub repo private. Clone over SSH so secrets never live in HTTPS URLs. Nothing in this repo should contain credentials — but treat it as you would ~/.ssh/.