← All docs

The flowwork skill

Install the Claude Code skill so authoring and operating workflows is easier and largely automated.

flowwork ships a Claude Code skill that teaches the agent the whole loop — author → register → run → drive — in the JavaScript DSL via flowctl. With it installed, you can describe what you want in plain language and let Claude Code write the workflow, register it, start runs, and resume parked forms/agents for you.

Install

The skill is bundled inside the flowctl binary — install it in one command:

flowctl skill install              # asks: global (~/.claude/skills) or local (./.claude/skills)
flowctl skill install --global     # ~/.claude/skills/flowwork
flowctl skill install --local      # ./.claude/skills/flowwork (current project)
flowctl skill install --force      # overwrite an existing copy
flowctl skill list                 # show bundled skills

skill install probes the engine’s license and installs the right variant automatically.

What the skill gives the agent

  • The DSL cheatsheet — the full builder/option tables and a copy-ready skeleton, so generated workflows use the right shapes the first time.
  • The CLI reference — every flowctl command for registering and driving runs.
  • The channels guide — how to set up bidirectional HITL so parked forms and agent() prompts are pushed into the session.
  • Trigger guidance — cron, collision policies, and the scheduling gotchas.
Free vs Pro

The free skill is the cheatsheet plus the CLI and channel references. The Pro skill adds a complete, section-by-section DSL reference and a library of worked, copy-ready example workflows covering every construct. With a paid license active, flowctl skill install writes the Pro variant automatically.

Why it matters

flowwork is built to be driven by an agent. The skill plus channels turn “write and run a durable workflow” into a conversation: the agent authors it, starts it with a channel attached, and answers the agent() prompts and forms the run raises — no hand-copying schemas or polling. Installing the skill is the fastest way to get there.