Agent skill

Windmill Bun Script Writer

by windmill-labs in windmill-labs/windmill

Guides your agent through writing Windmill scripts in TypeScript on Bun, then previewing, regenerating metadata and deploying them with the wmill CLI.

Custom licenceAuto-check passedDevelopment

Install Windmill Bun Script Writer

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

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

GitHub CLI
$ gh skill install windmill-labs/windmill write-script-bun --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-script-bun .claude/skills/write-script-bun && 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-script-bun
GitHub stars
18k
Token cost
~9.7k tokens
SKILL.md length
4,823 words
Files
1
Skills in repo
42
Repo updated
First seen
Licence
Custom licence

At a glance

Guides your agent through writing Windmill scripts in TypeScript on Bun, then previewing, regenerating metadata and deploying them with the wmill CLI.

  • Writing a new TypeScript script for a Windmill workspace
  • SKILL.md covers CLI Commands, General Principles, Return Values and Preprocessor Scripts, plus 7 more sections
  • Calls git; needs WM_TOKEN
  • Testing a local script edit without deploying it

What it does

Bun is treated as the standard TypeScript runtime for Windmill scripts, with Deno kept for scripts that specifically depend on it. The skill tells the agent to place scripts in a folder and, once the code is written, to explain which wmill command fits what you want to do next.

The key rule is choosing by intent. Trying a local edit uses wmill script preview, which executes the file without deploying. The wmill script run command is only for the version already deployed in the workspace, and a deploy through git push or wmill sync push happens only when you ask for one. After an import is added or removed, or the arguments of main change, the agent runs wmill generate-metadata so the .script.yaml schema, the .lock file and wmill-lock.yaml match the code.

When your agent uses it

  • Writing a new TypeScript script for a Windmill workspace
  • Testing a local script edit without deploying it
  • Refreshing the lock file and input schema after changing imports or arguments

Example prompts

  • “Write a Windmill script in TypeScript that fetches open invoices and returns the total.”
  • “Try out the script I just edited in the workspace folder.”
  • “I added an import to the sync script, so make sure the lock and schema files are up to date.”

Requirements

  • The wmill CLI
  • A Windmill workspace

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

    Links to these hosts (documentation or services it may open):

    • windmill.dev

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • WM_TOKEN

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

Context cost

Windmill Bun Script Writer loads about 9.7k tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 4,823 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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 4,823 words (~9,730 tokens).

name
write-script-bun

Read the full SKILL.md on GitHub

Files

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

Open the folder on GitHubat commit eab3dd5

Compare with similar skills

Windmill Bun Script Writer 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.

Windmill Bun Script Writer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Windmill Bun Script Writer this skillwindmill-labs/windmill18k—~9.7kAutomated safety check: PassCustom licence
TS SDK Authormindfold-ai/Trellis15k—~6.1kAutomated safety check: PassMIT
Prepare Rslint npm Releaseweb-infra-dev/rslint460—~1.5kAutomated safety check: PassMIT
Pump Build Releasenirholas/pump-fun-sdk133—~620Automated safety check: PassCustom licence
Releasear-io/ar-io-node127—~4.2kAutomated safety check: NotesAGPL-3.0
AWS Cdk Developmentzxkane/aws-skills3672 repos~2.5kAutomated safety check: PassMIT

Similar skills

  • TS SDK Author

    mindfold-ai/Trellis

    Design, build, verify, and publish production-grade TypeScript SDKs as npm packages inside a pnpm monorepo.

    15k GitHub stars~6.1k tokensUpdated 8 days ago
    DevelopmentAuto-check passed
  • Prepare Rslint npm Release

    web-infra-dev/rslint

    Prepare a stable release PR for the unified rslint npm packages by updating package versions and rule/TypeScript release metadata.

    460 GitHub stars~1.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Pump Build Release

    nirholas/pump-fun-sdk

    Build and release pipeline for the Pump SDK — tsup TypeScript builds, Cargo release profiles, semantic release with commitizen, npm publishing, linting, Makefile targets, Vercel deployment, and MCP…

    133 GitHub stars~620 tokensUpdated 18 days ago
    DevelopmentAuto-check passed
  • Release

    ar-io/ar-io-node

    Drive the AR.IO Node release process end-to-end — preflight checks, prepare commit, finalize with image SHAs, test docker compose profiles, tag & publish, and post-release cleanup.

    127 GitHub stars~4.2k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • AWS Cdk Development

    zxkane/aws-skills

    AWS Cloud Development Kit (CDK) expert for building cloud infrastructure with TypeScript/Python.

    367 GitHub starsUsed in 2 repos~2.5k tokens
    DevOps & CloudAuto-check passed
  • Skyvern Browser Automation

    Skyvern-AI/skyvern

    Automates websites with Skyvern's AI browser agent to fill forms, extract data, download files, log in and run multi-step workflows through SDKs, REST, MCP or a CLI.

    23k GitHub stars~1.9k tokensUpdated today
    Productivity & AutomationAuto-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

Works with

Categories

Questions about Windmill Bun Script Writer

What does Windmill Bun Script Writer do?

Guides your agent through writing Windmill scripts in TypeScript on Bun, then previewing, regenerating metadata and deploying them with the wmill CLI. Bun is treated as the standard TypeScript runtime for Windmill scripts, with Deno kept for scripts that specifically depend on it. The skill tells the agent to place scripts in a folder and, once the code is written, to explain which wmill command fits what you want to do next.

When should I use Windmill Bun Script Writer?

Windmill Bun Script Writer fits situations like: writing a new TypeScript script for a Windmill workspace; testing a local script edit without deploying it; refreshing the lock file and input schema after changing imports or arguments.

How do I install Windmill Bun Script Writer in Claude Code?

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

How do I install Windmill Bun Script Writer in Codex?

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

Can I use Windmill Bun Script Writer 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-script-bun -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-script-bun, .gemini/skills/write-script-bun, .github/skills/write-script-bun and .opencode/skills/write-script-bun in your project.

What does Windmill Bun Script Writer need to run?

Going by SKILL.md and its folder, Windmill Bun Script Writer needs the command-line tools its instructions call (git) and credentials named WM_TOKEN. Our summary lists: The wmill CLI; A Windmill workspace.

Does Windmill Bun Script Writer access the network?

SKILL.md names 1 domain. As links in the text: windmill.dev. This is read from the text; nothing was executed.

Is Windmill Bun Script Writer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Windmill Bun Script Writer use?

Windmill Bun Script Writer 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 Windmill Bun Script Writer use?

About 9.7k tokens (SKILL.md is roughly 39k 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 Windmill Bun Script Writer?

Skills that share tags, products or a category with Windmill Bun Script Writer: TS SDK Author (mindfold-ai/Trellis, 15k stars), Prepare Rslint npm Release (web-infra-dev/rslint, 460 stars), Pump Build Release (nirholas/pump-fun-sdk, 133 stars) and Release (ar-io/ar-io-node, 127 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Windmill Bun Script Writer?

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.