code-review

cc-tools

A personal collection of Claude Code agents and skills, packaged as a marketplace of small, single-purpose plugins.

This is an opinionated set — it's the toolbox I actually use, grouped by what each tool is for rather than what it is. A few of these are honestly tuned to my own projects (Python/Django, an ADR + plan + exec workflow, a Context7 MCP), so they won't all drop cleanly into a different setup. I've flagged that per plugin below. Even where a tool doesn't fit you as-is, it might give you ideas for building your own.

Install

Add the marketplace, then install the plugins you want:

/plugin marketplace add pySilver/cc-tools

/plugin install planning@silver-cc-tools
/plugin install code-review@silver-cc-tools
/plugin install git@silver-cc-tools
/plugin install research@silver-cc-tools

Test a plugin locally before installing:

claude --plugin-dir plugins/planning

Validate the marketplace and a plugin:

claude plugin validate .
claude plugin validate ./plugins/planning

After install, components are namespaced by plugin: skills are invoked as /planning:refine-plan-against-codex, /code-review:code-hygiene, /git:finalize-feature-branch, /research:web-research. The adr-review agent is picked up automatically (or when you ask for it by name).

cp plugins/planning/agents/adr-review.md ~/.claude/agents/
cp -r plugins/planning/skills/refine-plan-against-codex ~/.claude/skills/
chmod +x ~/.claude/skills/refine-plan-against-codex/references/*.sh \
         ~/.claude/skills/refine-plan-against-codex/references/state.py

cp -r plugins/code-review/skills/code-hygiene ~/.claude/skills/

cp -r plugins/git/skills/finalize-feature-branch ~/.claude/skills/

cp -r plugins/research/skills/web-research ~/.claude/skills/

Updating

Plugin versions are intentionally omitted from the manifests, so every commit to this repo is a new version. The /plugin menu has two update paths:

• /plugin → Marketplaces → Update marketplace — pulls the latest catalog from the repo immediately. The reliable way to get updates.
• /plugin → Installed → Update now — uses a local cache that can lag. Use it as a fallback after updating the marketplace.

Enable /plugin → Marketplaces → Enable auto-update to refresh the catalog on each session start.

Plugins

planning

Quality gates that run before code is written: review the decision (ADR), then harden the plan.

adr-review — a read-only agent that reviews the decision, not the implementation. It checks an ADR is actually decided (no hedging), that alternatives are weighed honestly (no strawmen), that consequences include the downsides, and that load-bearing decisions respect project invariants. Every finding is tagged and tied to a specific ADR section; the verdict is APPROVE or NEEDS REVISION. If the ADR file is ambiguous, it lists docs/adrs/ and asks rather than guessing.

Tuned for my setup. It expects ADRs in docs/adrs/YYYY-MM-DD-<task>.md and reads project context from a docs/adrs/*-dev-workflow.md, the root CLAUDE.md, and .claude/rules/*.md. On a repo without those, it still reviews the ADR but the load-bearing checks lose their teeth. Adapt the paths in agents/adr-review.md to reuse it elsewhere.