skills

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.

Inspect and register subscriptions and api keys. Run `bunx smithers-orchestrator agents --help` for usage details.

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.

Ask a question about Smithers using your installed agent and the Smithers MCP server. Run `bunx smithers-orchestrator ask --help` for usage details.

Safely halt agents and terminate a run. Run `bunx smithers-orchestrator cancel --help` for usage details.

Create and start a one-task auto-hijacked chat run. Run `bunx smithers-orchestrator chat-create --help` for usage details.

Show agent chat output for the latest run or a specific run. Run `bunx smithers-orchestrator chat --help` for usage details.

Manage and run background schedule triggers. Run `bunx smithers-orchestrator cron --help` for usage details.

Deny a paused approval gate. Run `bunx smithers-orchestrator deny --help` for usage details.

Print DiffBundle as unified diff. Run `bunx smithers-orchestrator diff --help` for usage details.

Print llms-full.txt (full docs bundle for LLMs) for this CLI version. Run `bunx smithers-orchestrator docs-full --help` for usage details.

Print llms.txt (concise docs index for LLMs) for this CLI version. Run `bunx smithers-orchestrator docs --help` for usage details.

Cancel all active runs. Like 'docker compose down' for workflows. Run `bunx smithers-orchestrator down --help` for usage details.

Run a workflow over a JSON/JSONL eval suite and write a regression report. Run `bunx smithers-orchestrator eval --help` for usage details.

Query run event history with filters, grouping, and NDJSON output. Run `bunx smithers-orchestrator events --help` for usage details.

Create a branched run from a snapshot checkpoint (time travel). Run `bunx smithers-orchestrator fork --help` for usage details.

Render the workflow graph without executing it. Run `bunx smithers-orchestrator graph --help` for usage details.

Open a directory as a workspace in Smithers GUI. Run `bunx smithers-orchestrator gui --help` for usage details.

Hand off the latest resumable agent session or conversation for a run. Run `bunx smithers-orchestrator hijack --help` for usage details.

List and resolve durable human requests. Run `bunx smithers-orchestrator human --help` for usage details.

Install the local Smithers workflow pack into .smithers/. Run `bunx smithers-orchestrator init --help` for usage details.

Output detailed run state, including steps, agents, approvals, and outputs. Run `bunx smithers-orchestrator inspect --help` for usage details.

Tail the event log of a specific run. Run `bunx smithers-orchestrator logs --help` for usage details.

View and query cross-run memory facts. Run `bunx smithers-orchestrator memory --help` for usage details.

Show enriched node details for debugging retries, tool calls, and output. Run `bunx smithers-orchestrator node --help` for usage details.

Start the local observability stack (Grafana, Prometheus, Tempo, OTLP Collector) via Docker Compose. Run `bunx smithers-orchestrator observability --help` for usage details.

Generate AI SDK tools from OpenAPI specs. Run `bunx smithers-orchestrator openapi --help` for usage details.

Run GEPA prompt optimization over a workflow eval suite and write an optimized prompt artifact. Run `bunx smithers-orchestrator optimize --help` for usage details.

Print node output row. Run `bunx smithers-orchestrator output --help` for usage details.

List active, paused, and recently completed runs. Run `bunx smithers-orchestrator ps --help` for usage details.

Fork from a checkpoint and resume execution (time travel). Run `bunx smithers-orchestrator replay --help` for usage details.

Restore a worktree to a durability checkpoint (latest for the node, or --seq). Run `bunx smithers-orchestrator restore --help` for usage details.

Retry a specific task within a run, then resume the workflow. Run `bunx smithers-orchestrator retry-task --help` for usage details.

Revert the workspace to a previous task attempt's filesystem state. Run `bunx smithers-orchestrator revert --help` for usage details.

Rewind a run to a previous frame. Run `bunx smithers-orchestrator rewind --help` for usage details.

View scorer results for a specific run. Run `bunx smithers-orchestrator scores --help` for usage details.