Agent skill

Windmill Bun Native Scripts

by windmill-labs in windmill-labs/windmill

Rules for writing Windmill Bun Native scripts that begin with a //native marker, plus the wmill commands for previewing, syncing and refreshing metadata.

Custom licenceAuto-check passedDevelopment

Install Windmill Bun Native Scripts

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

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

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

At a glance

Rules for writing Windmill Bun Native scripts that begin with a //native marker, plus the wmill commands for previewing, syncing and refreshing metadata.

  • Creating a Windmill script that has to run on the native worker
  • SKILL.md covers CLI Commands, General Principles, Return Values and Preprocessor Scripts, plus 7 more sections
  • Calls git; needs WM_TOKEN
  • Checking changes to a local Bun Native script before any deploy

What it does

Bun Native scripts run on Windmill's native worker, and the one requirement the description states is that the file starts with the //native line. The skill is meant to be picked up whenever a script of this kind is requested.

Alongside the script itself, it explains how to work in the local folder. The preview command is the default way to try changes, the run command targets only what is already deployed, and pushing with git or wmill sync push counts as a deploy that needs your explicit request. Whenever imports or the arguments of main change, the agent reruns generate-metadata so the generated schema and lock files stay consistent with the hashes tracked in wmill-lock.yaml.

When your agent uses it

  • Creating a Windmill script that has to run on the native worker
  • Checking changes to a local Bun Native script before any deploy
  • Keeping generated lock and schema files aligned after edits

Example prompts

  • “Write a native Windmill script that posts a short message to a webhook.”
  • “Preview my local edits to the notify script, but do not push anything.”
  • “Run the version of the report script that is already deployed.”

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 Native Scripts loads about 10k tokens when it runs. Until then it costs about 32 tokens; SKILL.md has 4,963 words of instructions outside code blocks.

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

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,963 words (~9,993 tokens).

name
write-script-bunnative

Read the full SKILL.md on GitHub

Files

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

Open the folder on GitHubat commit eab3dd5

Compare with similar skills

Windmill Bun Native Scripts 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 Native Scripts compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Windmill Bun Native Scripts this skillwindmill-labs/windmill18k—~10kAutomated safety check: PassCustom licence
Warp Factory Fileswarpdotdev/warp65k1 repos~2.5kAutomated safety check: PassAGPL-3.0
Gated Module ImplementationAlephantAI/AIephant-AI-Agent-Gateway114—~2.7kAutomated safety check: PassGPL-3.0
Review PR UI Screenshotsxiaocang/easydict_win32101—~1.2kAutomated safety check: PassGPL-3.0
Add Workflow Node Typetakeshy/obsidian-gemini-helper117—~450Automated safety check: NotesMIT
Parallel Batch OperationsQwenLM/qwen-code28k—~2.3kAutomated safety check: PassApache-2.0

Similar skills

  • Warp Factory Files

    warpdotdev/warp

    Authors and edits file-based Warp software factory definitions rooted at factory.yaml, covering agents, automations, scorers and webhooks, and validates them before a pull request.

    65k GitHub starsUsed in 1 repo~2.5k tokens
    DevelopmentAuto-check passed
  • Gated Module Implementation

    AlephantAI/AIephant-AI-Agent-Gateway

    Plan-first, one-time human plan approval; batched execution in either Gated (human confirms between batches) or Auto-loop (continuous run after plan approval); strict task-state updates; automatic…

    114 GitHub stars~2.7k tokensUpdated 3 mo ago
    DevelopmentAuto-check passed
  • Review PR UI Screenshots

    xiaocang/easydict_win32

    Download and review Easydict pull request CI screenshot artifacts from GitHub Actions using gh, then verify whether each screenshot matches its filename and artifact directory.

    101 GitHub stars~1.2k tokensUpdated 15 days ago
    DevelopmentAuto-check passed
  • Add Workflow Node Type

    takeshy/obsidian-gemini-helper

    Guides the agent through every file that must change to register a new node type in the Obsidian Gemini Helper workflow engine, then through lint and build checks.

    117 GitHub stars~450 tokensUpdated today
    DevelopmentAuto-check: notes
  • Runs one operation across many files with parallel worker agents: finds files by glob pattern, splits them into chunks, launches workers and summarizes the results.

    28k GitHub stars~2.3k tokensUpdated today
    DevelopmentAuto-check passed
  • GitHub Automation

    ruvnet/ruflo

    GitHub workflow automation, PR management, issue tracking, and code review coordination.

    74k GitHub starsUsed in 2 repos~368 tokens
    DevelopmentAuto-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

Categories

Questions about Windmill Bun Native Scripts

What does Windmill Bun Native Scripts do?

Rules for writing Windmill Bun Native scripts that begin with a //native marker, plus the wmill commands for previewing, syncing and refreshing metadata. Bun Native scripts run on Windmill's native worker, and the one requirement the description states is that the file starts with the //native line. The skill is meant to be picked up whenever a script of this kind is requested.

When should I use Windmill Bun Native Scripts?

Windmill Bun Native Scripts fits situations like: creating a Windmill script that has to run on the native worker; checking changes to a local Bun Native script before any deploy; keeping generated lock and schema files aligned after edits.

How do I install Windmill Bun Native Scripts in Claude Code?

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

How do I install Windmill Bun Native Scripts in Codex?

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

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

What does Windmill Bun Native Scripts need to run?

Going by SKILL.md and its folder, Windmill Bun Native Scripts 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 Native Scripts 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 Native Scripts 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 Native Scripts use?

Windmill Bun Native Scripts 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 Native Scripts use?

About 10k tokens (SKILL.md is roughly 40k 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 Native Scripts?

Skills that share tags, products or a category with Windmill Bun Native Scripts: Warp Factory Files (warpdotdev/warp, 65k stars), Gated Module Implementation (AlephantAI/AIephant-AI-Agent-Gateway, 114 stars), Review PR UI Screenshots (xiaocang/easydict_win32, 101 stars) and Add Workflow Node Type (takeshy/obsidian-gemini-helper, 117 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Windmill Bun Native Scripts?

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.