Skip to content
Back to search

slim-claude

MarketplaceWorks with Claude CodeGitHub

Orchestrator, specialist subagents, skills, and hooks for Claude Code. Adapted from oh-my-opencode-slim.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/aw4e--slim-claude/badge.svg)](/listings/aw4e--slim-claude)

HTML

<a href="/listings/aw4e--slim-claude"><img src="/api/listings/aw4e--slim-claude/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. **Install**

   /plugin marketplace add aw4e/slim-claude
   /plugin install slim-claude@slim-claude

To try it from a local checkout instead: `claude --plugin-dir <path-to-this-folder>`. 2. **Start with the orchestrator.** A plugin cannot make an agent the default, so either launch with it:

   claude --agent slim-claude:orchestrator

or set it once in your own `~/.claude/settings.json` (or a project's `.claude/settings.json`):

   { "agent": "slim-claude:orchestrator" }

Without this step the plugin still adds its agents and skills, but nothing delegates for you. 3. **Try it.** Ask for something with a few parts, for example: *"Find where auth is handled, then have someone review the design and implement the fix."* The orchestrator should dispatch `explorer`, `oracle`, and `fixer` as subagents. Run `/agents` to see everything the plugin added, and `/slim-claude:council <question>` for a multi-model second opinion. 4. **Keep costs in check.** `/slim-claude:preset` switches the model tier (`cheap`, `balanced`, `max`).

Nothing else is required. Obsidian, Orca, `rtk`, and a debugger backend are optional and skipped when absent.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines
  1. {
  2. "name": "slim-claude",
  3. "owner": {
  4. "name": "aw4e",
  5. "url": "https://github.com/aw4e"
  6. },
  7. "plugins": [
  8. {
  9. "name": "slim-claude",
  10. "source": "./",
  11. "description": "Orchestrator and specialist subagents for Claude Code."
  12. }
  13. ],
  14. "description": "Orchestrator, specialist subagents, skills, and hooks for Claude Code. Adapted from oh-my-opencode-slim."
  15. }
README.md · README · 135 lines
  1. # slim-claude
  2. <p align="center">
  3. <picture>
  4. <source media="(prefers-color-scheme: dark)" srcset="assets/logo-white.svg">
  5. <img src="assets/logo.svg" alt="slim-claude logo" width="96" height="96">
  6. </picture>
  7. </p>
  8. An orchestrator that plans work and hands it to specialist subagents (search, architecture review,
  9. UI, implementation, audits), plus skills and a few safety hooks, for Claude Code. Adapted from
  10. [oh-my-opencode-slim](https://github.com/alvinunreal/oh-my-opencode-slim) (MIT).
  11. > **Status: beta (v0.1.0).** Passes `claude plugin validate`; the hooks have automated tests (41 cases) and a
  12. > fresh-clone release gate. A live smoke suite (`scripts/smoke-live.mjs`, 36 real `claude -p` sessions on Windows)
  13. > confirms that with the orchestrator as main agent every agent is dispatched, read-only agents stay read-only,
  14. > the council runs 3 seats on 3 models plus a synthesis, and all skills load. Seven cases plant a known defect
  15. > (SQL injection, swallowed error, untested branch, duplicated code, off-by-one, var/closure) and check the audit
  16. > agents name it, plus one clean-code control; this measures recall on small cases, not general review quality. Not yet verified: interactive sessions, macOS and Linux. Issues welcome.
  17. ## Quick start
  18. 1. **Install**
  19. ```
  20. /plugin marketplace add aw4e/slim-claude
  21. /plugin install slim-claude@slim-claude
  22. ```
  23. To try it from a local checkout instead: `claude --plugin-dir <path-to-this-folder>`.
  24. 2. **Start with the orchestrator.** A plugin cannot make an agent the default, so either launch with it:
  25. ```
  26. claude --agent slim-claude:orchestrator
  27. ```
  28. or set it once in your own `~/.claude/settings.json` (or a project's `.claude/settings.json`):
  29. ```json
  30. { "agent": "slim-claude:orchestrator" }
  31. ```
  32. Without this step the plugin still adds its agents and skills, but nothing delegates for you.
  33. 3. **Try it.** Ask for something with a few parts, for example: *"Find where auth is handled, then have
  34. someone review the design and implement the fix."* The orchestrator should dispatch `explorer`,
  35. `oracle`, and `fixer` as subagents. Run `/agents` to see everything the plugin added, and
  36. `/slim-claude:council <question>` for a multi-model second opinion.
  37. 4. **Keep costs in check.** `/slim-claude:preset` switches the model tier (`cheap`, `balanced`, `max`).
  38. Nothing else is required. Obsidian, Orca, `rtk`, and a debugger backend are optional and skipped when absent.
  39. ## What's inside
  40. | Agent | Model | Job |
  41. |---|---|---|
  42. | orchestrator | session model | plans, delegates, verifies (run it as the main agent) |
  43. | explorer | haiku | read-only codebase search and docs research (uses `context7`, `gh_grep`) |
  44. | oracle | opus | architecture, hard debugging, review (read-only) |
  45. | designer | sonnet | UI/UX design and implementation |
  46. | fixer | sonnet | bounded implementation |
  47. | observer | sonnet | images, PDFs, screenshots, diagrams |
  48. | councillor / council | per seat / opus | multi-model consensus (see the `council` skill) |
  49. | janitor, paladin, arbiter, hunter, proctor | session model | read-only audits: maintainability, security, merge-readiness, error paths, test gaps |
  50. | validator, debugger, documenter, chronicler | session model | run tests/builds, live debugging (needs a debugger MCP), docs |
  51. Skills (invoke as `/slim-claude:<name>`): `deepwork` (multi-phase heavy builds), `interview` (spec Q&A),
  52. `council`, `worktrees` (isolated git lanes, Orca-aware), `codemap` (repo map), `clonedeps` (dependency source),
  53. `simplify`, `verification-planning`, `step-back`, `deanchor`, `ai-estimates`, `reflect`, `obsidian`
  54. (optional), `preset`, `slim-claude` (configure this plugin). Project state lives in `.slim-claude/`.
  55. Optional extras not loaded by default (reverse-engineering agents) are in [`extras/`](extras/README.md).
  56. ## Cost
  57. Every subagent is a separate model session with its own context, so delegating costs more than doing a small task
  58. yourself. Measured in the live suite on tiny tasks (orchestrator on the session model): one delegated task about
  59. $0.06-0.16, a council run about $0.18-0.23 (three seats plus a synthesis, one on opus). Real tasks on real
  60. projects will cost more and scale with how much code the agents read. Ways to stay in control:
  61. - Skip the orchestrator for small edits; start a plain session instead.
  62. - `/slim-claude:preset` with `cheap` moves search and chores to haiku and sonnet.
  63. - Use `council` and `oracle` (opus) only for decisions that deserve it.
  64. - Watch usage in your first sessions before pointing it at a large project.
  65. ## Hooks
  66. All local; nothing is sent anywhere. The guards ask for confirmation; they never deny.
  67. - `SessionStart`: points the session at `.slim-claude/codemap.json` and any active deepwork task, so resume and compaction keep context.
  68. - `UserPromptSubmit`: once per session, nudges toward the `council` skill when the prompt asks for consensus or a second opinion.
  69. - `PreToolUse` Bash: confirms force-push, `git reset --hard`, `git clean -f`, `rm -rf`, and worktree removal.
  70. - `PreToolUse` Write/Edit: confirms writes to `.env*` (except `.example`), `*.pem`, `*.key`, SSH keys, or content that looks like a cloud/GitHub/Anthropic/Slack key or private key block.
  71. - `PostToolUse` Write/Edit: after a `.json` edit, reports a parse error back to the model.
  72. Hooks run on Node by default (about 50 ms per call). An optional Rust port starts in about 7-9 ms; build it per machine:
  73. ```
  74. cd hooks/rust && cargo build --release
  75. node hooks/use-rust.mjs on # off | status
  76. node hooks/test.mjs --rust # parity check against the Node hooks
  77. ```
  78. The binary is git-ignored, so other users and OSes keep the Node default. A plugin update restores Node; re-run `on`.
  79. ## Customize
  80. Edit the `model:` line in any `agents/*.md`. Subagents can only use Claude models (`opus`, `sonnet`,
  81. `haiku`, or a full model ID). Add an agent by dropping a `.md` in `agents/` and a routing line in
  82. `agents/orchestrator.md`. The council roster is the table in `skills/council/SKILL.md`. Durable
  83. overrides go in `~/.claude/agents/` or `.claude/agents/` so plugin updates do not erase them.
  84. ## Development
  85. Release notes: [`CHANGELOG.md`](CHANGELOG.md).
  86. Before a release, run all three:
  87. ```
  88. claude plugin validate .
  89. node hooks/test.mjs # add --rust for the Rust hooks
  90. node scripts/check-fresh-clone.mjs # clones origin as a Windows user would (autocrlf=true) and re-validates
  91. node scripts/smoke-live.mjs # live: real claude -p sessions per agent/skill; costs money (~$2-3 in total)
  92. ```
  93. ## Not ported from oh-my-opencode-slim
  94. - Mixing non-Claude providers per agent, presets with fallback chains (needs a proxy).
  95. - tmux panes, TUI sidebar, interview browser dashboard, companion app, ast-grep tools.
  96. - OpenCode-specific hooks (apply-patch rewrite, foreground fallback, cache monitor, tool-loop guard).
  97. ## Credits and license
  98. MIT. Built on oh-my-opencode-slim and community agents from the oh-my-opencode marketplace, with
  99. `hunter` and `proctor` derived from Archon. Upstream copyright notices are retained in
  100. [`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md). Not affiliated with or endorsed by those projects.
  101. ## Privacy
  102. The bundled MCP servers (`context7`, `gh_grep`) are remote: library and code-search queries made by you
  103. or the agents are sent to mcp.context7.com and mcp.grep.app. Delete `.mcp.json` to disable them. The
  104. hooks run locally and send nothing. Full statement: [`PRIVACY.md`](PRIVACY.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.