Menu
Inspect and register subscriptions and api keys. Run `bunx smithers-orchestrator agents --help` for usage details.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | smithers-agents |
| description | Inspect and register subscriptions and api keys. Run `bunx smithers-orchestrator agents --help` for usage details. |
| requires_bin | bunx |
| command | bunx smithers-orchestrator agents |
Register a Smithers agent account (interactive wizard, or non-interactive via flags).
| Flag | Type | Default | Description |
|---|---|---|---|
--provider | string | Provider id; omit to launch the interactive wizard | |
--label | string | Unique label, e.g. 'claude-work' | |
--configDir | string | Path to the per-account CLI config dir (subscription providers) | |
--apiKey | string | API key (api-key providers only) | |
--model | string | Default model for this account | |
--skipLogin | boolean | false | Skip the 'is the dir populated?' check (advanced) |
--force | boolean | false | Register even if no credentials are present |
--replace | boolean | false | Overwrite an existing account with the same label |
--loop | boolean | false | Wizard mode only: keep adding accounts until you say done |
Print a JSON report of the built-in CLI agent capability registries.
Validate built-in CLI agent capability registries and command-surface contracts.
| Flag | Type | Default | Description |
|---|---|---|---|
--json | boolean | false | Print the doctor report as JSON |
List all registered Smithers agent accounts. Use --format json for machine output.
Remove a Smithers agent account by label.
| Name | Type | Required | Description |
|---|---|---|---|
label | string | yes | Account label to remove |
| Flag | Type | Default | Description |
|---|---|---|---|
--silent | boolean | false | Do not error if the label is not registered |
Spawn the account's underlying CLI with --version to verify it is reachable.
| Name | Type | Required | Description |
|---|---|---|---|
label | string | yes | Account label to ping |
Create structured plans for multi-step tasks -- software features, research workflows, events, study plans, or any goal that benefits from breakdown. Also deepens existing plans with interactive sub-agent review. Use when the user says 'plan this', 'create a plan', 'how should we build', 'break this down', or when a brainstorm doc is ready for planning. Use 'deepen the plan' or 'deepening pass' for the deepening flow. For exploratory requests, prefer ce-brainstorm first.
Select the right Bead to work on using Beads robot-mode CLI evidence. Use when asked what Bead to pick next, which local issue is highest leverage, which blocker to clear, or how to choose work from a Beads graph. Produces a validator-checked .laguna/bead-selection.json artifact grounded in bv/br robot output, never the interactive bv TUI.
Inventory the top level of a workspace and write .laguna/workspace-inventory.json. Use when an agent or user needs a quick orientation snapshot: what top-level entries exist, which are files vs directories, and how many files each directory contains. Triggers on requests like "what's at the top of this workspace", "give me a lay of the land", "list the top-level structure", "how many files are in each directory", or any task whose first step is understanding what is present without doing deep analysis. Every claim (entry names, kinds, file counts, total) is mechanically checkable against the real filesystem tree.
List and manage durable alert instances. Run `bunx smithers-orchestrator alerts --help` for usage details.
Approve a paused approval gate. Auto-detects the pending node if only one exists. Run `bunx smithers-orchestrator approve --help` for usage details.
Raise a blocking human-approval request from inside a run and wait for the decision. Use when blocked, uncertain, or about to do something irreversible — never guess. Run `bunx smithers-orchestrator ask-human --help` for usage details.
