"What pattern fits src/checkout.ts?"
"Refactor this pricing logic — it has a big if-else chain"
"Compare Strategy vs Factory for services/OrderService.kt"
"Implement notify(kind, msg) with the right pattern"
See it on real code → Case studies — production refactors with scoring matrices, before/after diffs, and verification.
Trust & Transparency
This section exists specifically because Claude Code shows a trust warning
on every plugin install. You should read it before installing anything.
What this skill is
A skill (a plain Markdown file) that gives Claude Code structured instructions
for recommending and applying design patterns. There is no compiled code, no binary,
no MCP server, and no background process.
What it can access
The allowed-tools in skills/pattern-surgeon/SKILL.md
are declared explicitly:
allowed-tools: Bash Read
| Tool | What it does in this skill |
|---|
Read | Reads the file or function you explicitly point it at |
Bash | Runs verify.sh, checkpoint.sh, rollback.sh — the safety scripts in this repo |
What it never does
- Never reads files you did not name
- Never scans your repo unprompted ("reactive only" — stated in the description frontmatter)
- Never makes network requests
- Never writes to files without first creating a git checkpoint and asking for confirmation
- Never keeps a change if typecheck or tests fail
What the safety scripts do
You can read every line — they are plain bash:
Verify yourself
git clone https://github.com/nuhin13/pattern-surgeon
cat skills/pattern-surgeon/SKILL.md # the full skill instructions
cat skills/pattern-surgeon/scripts/verify.sh # the verification script
bats tests/scripts/ # run all 8 test suites
Install
Option 1 — Claude Code plugin
In a Claude Code session, run these two commands:
/plugin marketplace add nuhin13/pattern-surgeon
/plugin install pattern-surgeon
The skill activates automatically from its description — no slash command needed.
Update:
/plugin update pattern-surgeon
Uninstall:
/plugin remove pattern-surgeon
Option 2 — npx (no Node project required)
npx @nuhin13/pattern-surgeon # installs to ~/.claude/skills/
npx @nuhin13/pattern-surgeon --project # installs to .claude/skills/ (current project only)
npx @nuhin13/pattern-surgeon remove # uninstall global
npx @nuhin13/pattern-surgeon remove --project # uninstall project-local
Option 3 — npm global
npm install -g @nuhin13/pattern-surgeon
Option 4 — shell one-liner
curl -fsSL https://raw.githubusercontent.com/nuhin13/pattern-surgeon/main/install.sh | bash
Project-local (commit to git so your team gets it):
curl -fsSL https://raw.githubusercontent.com/nuhin13/pattern-surgeon/main/install.sh | bash -s -- --project
git add .claude/skills/pattern-surgeon && git commit -m "add pattern-surgeon skill"
Option 5 — clone (zero install for contributors)
git clone https://github.com/nuhin13/pattern-surgeon
.claude/skills/pattern-surgeon is already a symlink to skills/pattern-surgeon/.
Claude Code picks it up automatically — no install step.
Supported languages
