---
name: smithersai-smithers-init
description: "Install the local Smithers workflow pack into .smithers/. Pass an optional prompt to also launch the create-workflow builder after init. Run `smithers init --help` for usage details."
license: "MIT"
metadata:
  decimalai-skill-id: "da562d9b-dce6-4b25-806b-9d46ecca2c99"
  decimalai-version-id: "517872aa-f0c7-43c5-ae7a-e18e6962c561"
  decimalai-version: "1"
  decimalai-body-sha256: "1e81dc2cfd642e845358413bcd40bb09dc4d9829f93e3b7ec8f84a914a6a63f0"
  decimalai-name: "smithersai/smithers-init"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "agent-tooling"
  decimalai-source: "https://app.decimal.ai/s/smithersai-smithers-init@1/SKILL.md"
---
# smithers init

Install the local Smithers workflow pack into .smithers/. Pass an optional prompt to also launch the create-workflow builder after init.

## Arguments

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `prompt` | `string` | no | Optional plain-English task: after init, launch the create-workflow builder with this prompt pre-filled |

## Options

| Flag | Type | Default | Description |
|------|------|---------|-------------|
| `--agent` | `string` |  | Preferred coding agent id (e.g. claude, codex, pi). Skips the interactive agent question. |
| `--tutorial` | `boolean` | `true` | After install, open a hijacked tutorial session hosted by your preferred agent (interactive init only). Use --no-tutorial to skip. |
| `--force` | `boolean` | `false` | Overwrite existing scaffold files |
| `--agentsOnly` | `boolean` | `false` | Only create .smithers/agents/ and leave the rest of the workflow pack untouched |
| `--install` | `boolean` | `true` | Run `bun install` inside .smithers/ after scaffolding (--no-install to skip) |
| `--addAgents` | `boolean` | `false` | After scaffolding, launch the interactive `agents add` wizard to register one or more accounts. |
| `--skill` | `boolean` | `true` | Install the curated `smithers` skill into your detected coding agents (Claude Code, Pi, Codex, OpenCode, Kimi, Amp, Antigravity) and, if a CLAUDE.md or AGENTS.md exists, append guidance on when to use smithers.sh workflows. Use --no-skill to skip. |
| `--global` | `boolean` | `false` | Scaffold the global pack in ~/.smithers (honors SMITHERS_HOME) instead of ./.smithers. Global workflows run from any repo; a repo's local pack takes precedence. |
| `--updatePrompt` | `boolean` | `true` | In an interactive terminal, when shipped pack files differ from the latest bundled version, ask which to update (warning when a shared component is selected). Use --no-update-prompt to skip the question. |
| `--template` | `unknown` |  | Show next steps for a canonical starter template ID after init |
| `--yes` | `boolean` | `false` | Non-interactive: skip prompts and use defaults (safe for agents and CI). Alias: --non-interactive. |
| `--nonInteractive` | `boolean` | `false` | Non-interactive: skip prompts and use defaults (safe for agents and CI). Alias: --yes. |
