Skip to main content
create-skill turns a plain-English description into a real, agent-facing SKILL.md (plus supporting files). It’s the skill-authoring counterpart to create-workflow: describe what the skill should equip an agent to do, and the workflow clarifies it, designs the structure, scaffolds files, and documents the result.
By default it pauses for design approval before any files are written. Clear the gate with bunx smithers-orchestrator approve RUN_ID --node approve-design, or run autonomously with --input '{"review":false}'.

​
Stages

  1. clarify: turn the freeform ask into a structured skill spec (purpose, when-to-use, capabilities, inputs).
  2. design: produce the concrete SKILL.md blueprint (frontmatter, body sections, supporting files).
  3. approve-design: durable human approval gate (skippable via review: false).
  4. scaffold: write SKILL.md (and supporting files) under .smithers/skills/.
  5. document: summarize what was created and where.

​
Inputs

Use this when you want to capture a repeatable agent capability as a reusable skill without hand-authoring SKILL.md yourself.