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).
Manual install (alternative)
Copy the files you want straight into your Claude Code config directory. Agents go under ~/.claude/agents/, skills under ~/.claude/skills/. Restart Claude Code afterward.
planning — adr-review agent + refine-plan-against-codex skill:
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
code-review — code-hygiene skill:
cp -r plugins/code-review/skills/code-hygiene ~/.claude/skills/
git — finalize-feature-branch skill:
cp -r plugins/git/skills/finalize-feature-branch ~/.claude/skills/
research — web-research skill:
cp -r plugins/research/skills/web-research ~/.claude/skills/
Note: installed manually, skills lose the plugin: namespace — invoke them by bare name (/refine-plan-against-codex, /code-hygiene, etc.).
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
| Plugin | Description |
|---|
| planning | Pre-code design gates — ADR review + iterative plan hardening against Codex |
| code-review | Find agentic code smells: needless complexity and AI-speak docstrings/comments |
| git | Finalize a feature branch — rebase, squash to one commit, verify, push |
| research | Grounded web research with source-quality discipline and inline citations |
planning
Quality gates that run before code is written: review the decision (ADR), then harden the plan.
| Component | Trigger | Description |
|---|
| agent | adr-review | Reviews an Architecture Decision Record for decision quality before a plan is built on it |
| skill | /planning:refine-plan-against-codex <plan.md> | Review → fix → review loop on a plan file until Codex stops finding issues |
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.