musketeer

Distributable custom Claude Code harness. One declarative command scaffolds a curated company of musketeers (skills + agents + hooks) into any project's ./.claude/.

Install

npm i -g @phuc1403/musketeer

Use

musketeer muster     # self-update → pick company (multi-select) → refresh all selected skills to latest
musketeer promote    # update the musketeer CLI itself to the latest published version
musketeer            # show usage
musketeer --help     # show usage

musketeer muster self-updates first: it pulls the latest published version (re-execing when behind), so the refresh always applies the newest template. Set MUSKETEER_NO_SELF_UPDATE=1 to skip (offline / pinned).

It is also idempotent and force-updating: the picker pre-checks your current company (from .musketeer.json); on confirm it re-writes every selected musketeer's files to the latest template (overwriting any local edits), removes newly-unchecked ones, regenerates settings.json, and auto-installs any missing prerequisites.

musketeer promote upgrades the CLI tool itself (not your project's company): it checks the npm registry, and if a newer version exists, runs npm i -g @phuc1403/musketeer@latest. muster = which musketeers are in this project; promote = upgrade the binary.

Musketeers (v1)

| Musketeer | Default in muster | What it adds | |-----------|-------------------|--------------| | core | always on (locked, hidden) | research, handoff, skill-creator, git (+ git-manager agent) · statusline, usage-quota, format-json hooks | | architecture | off | adr-writer, architecture-characteristic-writer, context-map · CML validation hook | | hallmark | off | hallmark, hallmark-explore, hallmark-loop · auditor/explorer agents | | code-review | off | code-review skill + code-reviewer agent · a parallel naming pass on .cs diffs when the C# naming rule is installed | | dotnet | off | tdd, knowledge-crunching, logical-components · C# identifier naming rule (.claude/rules/, injected into every subagent by a SubagentStart hook; deleting the file turns it off until the next muster, deselecting dotnet removes it) · EF migration guard hook · always merges 4 quality-gate props into root Directory.Build.props (MUSKETEER_SKIP_DOTNET_PROPS=1 to skip) · scaffolds a generic src/tests Clean Architecture skeleton when the project is blank | | design-docs | off | inject-design-docs SessionStart hook |

The muster starts every musketeer unselected, except ones you already installed (pre-checked from .musketeer.json). core is always included and isn't shown as a toggle — it can't be removed.

Vocabulary: musketeer = a selectable unit · muster = the picker · company = your recruited set.

See INSTALLATION.md for prerequisites and auto-install behavior.