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.
bunx smithers-orchestrator approve RUN_ID --node approve-design, or run
autonomously with --input '{"review":false}'.
Stages
- clarify: turn the freeform ask into a structured skill spec (purpose, when-to-use, capabilities, inputs).
- design: produce the concrete
SKILL.mdblueprint (frontmatter, body sections, supporting files). - approve-design: durable human approval gate (skippable via
review: false). - scaffold: write
SKILL.md(and supporting files) under.smithers/skills/. - 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.