Agent skill

Write Flow

by windmill-labs in windmill-labs/windmill

“MUST use when creating flows.”

— description from SKILL.md by windmill-labs
Custom licenceAuto-check: warnings

Install Write Flow

The automated check flagged lines worth reading first. See the safety section below.

skills CLI
$ npx skills add windmill-labs/windmill --skill write-flow -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install windmill-labs/windmill write-flow --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/windmill-labs/windmill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/system_prompts/auto-generated/skills/write-flow .claude/skills/write-flow && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
write-flow
GitHub stars
18k
Token cost
~19k tokens
SKILL.md length
6,971 words
Files
1
Skills in repo
42
Repo updated
First seen
Licence
Custom licence

At a glance

  • Works in 3 steps: Gather path + summary by asking the user → Run the command yourself → Fill in flow.yaml
  • SKILL.md covers Creating a Flow, CLI Commands — running,…, OpenFlow Schema and Reserved Module IDs, plus 12 more sections
  • Calls git

About this skill

Write Flow is a skill in windmill-labs/windmill (18k stars). Its SKILL.md is about 19k tokens. Licence: Custom licence.

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Gather path + summary by asking the user
  2. Run the command yourself
  3. Fill in flow.yaml

What it can do on your machine

Read from SKILL.md and the folder at commit eab3dd5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Write Flow loads about 19k tokens when it runs. Until then it costs about 10 tokens; SKILL.md has 6,971 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~10
When it runs · the whole SKILL.md, loaded when a task matches
~19k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: warnings

The automated check found patterns that need a careful read before installing.

  • WarningContains instruction-override wording (e.g. “without asking the user”)SKILL.md:10
    nd-create the folder + `flow.yaml`, and do NOT tell the user to "run `wmill flow new` and follow the prompts".**

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 6,971 words (~19,382 tokens).

“You — the AI agent — scaffold the flow yourself by running wmill flow new with the right flags. Do NOT hand-create the folder + flow.yaml, and do NOT tell the user to "run wmill flow new and follow the…”

— opening of SKILL.md by windmill-labs, Custom licence
name
write-flow

Read the full SKILL.md on GitHub

Files

Just SKILL.md in system_prompts/auto-generated/skills/write-flow of windmill-labs/windmill.

Open the folder on GitHubat commit eab3dd5

Compare with similar skills

Write Flow next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Write Flow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Write Flow this skillwindmill-labs/windmill18k—~19kAutomated safety check: WarnCustom licence
Kotlin Coroutines Flowsaffaan-m/ECC274k4 repos~2kAutomated safety check: PassMIT
Kotlin Coroutines Flowsaffaan-m/ECC274k—~1.7kAutomated safety check: PassMIT
Login Flownexu-io/open-design100k—~334Automated safety check: PassApache-2.0
Project Flow Opsaffaan-m/ECC274k3 repos~787Automated safety check: PassMIT
Wireframe Mobile Flownexu-io/open-design100k—~1kAutomated safety check: PassApache-2.0

Similar skills

  • Kotlin Coroutines and Flow patterns for Android and KMP — structured concurrency, Flow operators, StateFlow, error handling, and testing.

    274k GitHub starsUsed in 4 repos~2k tokens
    DevelopmentAuto-check passed
  • Android および KMP 向けの Kotlin コルーチンと Flow パターン — 構造化並行性、Flow オペレーター、StateFlow、エラーハンドリング、テスト。

    274k GitHub stars~1.7k tokensUpdated 2 days ago
    MobileAuto-check passed
  • Login Flow

    nexu-io/open-design

    Mobile login and authentication flow screens. An agent skill from nexu-io/open-design.

    100k GitHub stars~334 tokensUpdated today
    Backend & APIsAuto-check passed
  • Project Flow Ops

    affaan-m/ECC

    Operate execution flow across GitHub and Linear by triaging issues and pull requests, linking active work, and keeping GitHub public-facing while Linear remains the internal execution layer.

    274k GitHub starsUsed in 3 repos~787 tokens
    DevelopmentAuto-check passed
  • Wireframe Mobile Flow

    nexu-io/open-design

    A lo-fi multi-screen MOBILE flow wireframe — three or four phone frames laid out in a row on a board, showing a connected user flow (Onboarding → Home feed → Item detail → Confirm).

    100k GitHub stars~1k tokensUpdated today
    Frontend & DesignAuto-check passed
  • UX Flow

    sickn33/agentic-awesome-skills

    Design user flows and navigation structure following proven UX patterns

    47k GitHub starsUsed in 1 repo~804 tokens
    Frontend & DesignAuto-check passed

More from windmill-labs/windmill

All 42 skills in this repo
  • Windmill Trigger Type Checklist

    windmill-labs/windmill

    Checklist of every backend, frontend, CLI and capture change needed to add a new TriggerCrud-based trigger type, such as Azure, GCP or Kafka, to Windmill.

    18k GitHub stars~4.7k tokensUpdated today
    Auto-check passed
  • Windmill AI Evals

    windmill-labs/windmill

    Writes and runs black-box benchmark cases for Windmill's flow, app, script, CLI and global AI generation modes, including before-and-after comparisons.

    18k GitHub stars~969 tokensUpdated today
    Auto-check: notes
  • Domain Modeling and Glossary

    windmill-labs/windmill

    Actively challenges vague or conflicting terminology as you design, and keeps a living domain glossary file up to date in real time.

    18k GitHub stars~622 tokensUpdated today
    Auto-check passed
  • Local PR Review

    windmill-labs/windmill

    Runs the same code review locally that GitHub's auto-review actions run on a PR, delegating to a fresh-context subagent so the review isn't biased by the main session's own reasoning.

    18k GitHub stars~995 tokensUpdated today
    Auto-check passed
  • Draft PR with CI Rounds

    windmill-labs/windmill

    Opens a draft GitHub pull request with a conventional title and explicit body, then drives CI review rounds before marking it ready.

    18k GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • Windmill Dev Page Preview

    windmill-labs/windmill

    Opens the Windmill dev page to preview a flow, script or app, choosing between proxy and direct mode and deciding whether the agent or the runtime starts the wmill dev server.

    18k GitHub stars~1.8k tokensUpdated today
    Auto-check passed

Questions about Write Flow

How do I install Write Flow in Claude Code?

Run `npx skills add windmill-labs/windmill --skill write-flow -a claude-code`. Or copy the skill folder (system_prompts/auto-generated/skills/write-flow in windmill-labs/windmill) into .claude/skills/write-flow in your project. Claude Code loads it when a task matches its description.

How do I install Write Flow in Codex?

Run `npx skills add windmill-labs/windmill --skill write-flow -a codex`. Or copy the skill folder (system_prompts/auto-generated/skills/write-flow in windmill-labs/windmill) into .agents/skills/write-flow in your project. Codex loads it when a task matches its description.

Can I use Write Flow in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add windmill-labs/windmill --skill write-flow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/write-flow, .gemini/skills/write-flow, .github/skills/write-flow and .opencode/skills/write-flow in your project.

What does Write Flow need to run?

Going by SKILL.md and its folder, Write Flow needs the command-line tools its instructions call (git).

Does Write Flow access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Write Flow safe to install?

Our automated static check of SKILL.md flagged 1 warning(s): contains instruction-override wording (e.g. “without asking the user”). Read the flagged lines before installing; the check is not a guarantee either way.

What licence does Write Flow use?

Write Flow has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Write Flow use?

About 19k tokens (SKILL.md is roughly 78k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Write Flow?

Skills that share tags, products or a category with Write Flow: Kotlin Coroutines Flows (affaan-m/ECC, 274k stars), Kotlin Coroutines Flows (affaan-m/ECC, 274k stars), Login Flow (nexu-io/open-design, 100k stars) and Project Flow Ops (affaan-m/ECC, 274k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Write Flow?

windmill-labs (a GitHub organization) maintains it in windmill-labs/windmill, which has 18,117 GitHub stars. The repository holds 42 skills in this directory. The repository was last updated on October 7, 2026.

Source: windmill-labs/windmill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.