Agent skill

Windmill Rust Backend Patterns

by windmill-labs in windmill-labs/windmill

Sets Rust conventions for the Windmill backend: error types, SQLx queries, JSON handling, async rules, module layout and rust-analyzer navigation.

Custom licenceAuto-check passedDevelopment

Install Windmill Rust Backend Patterns

skills CLI
$ npx skills add windmill-labs/windmill --skill rust-backend -a claude-code

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

GitHub CLI
$ gh skill install windmill-labs/windmill rust-backend --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/.agents/skills/rust-backend .claude/skills/rust-backend && 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
rust-backend
GitHub stars
18k
Token cost
~869 tokens
SKILL.md length
236 words
Files
1
Skills in repo
42
Repo updated
First seen
Licence
Custom licence

At a glance

Sets Rust conventions for the Windmill backend: error types, SQLx queries, JSON handling, async rules, module layout and rust-analyzer navigation.

  • Writing a new endpoint or job handler in the Windmill backend
  • SKILL.md covers Error Handling, SQLx Patterns, JSON Handling and Serde Optimizations, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Reviewing Rust code for SQLx and error-handling conventions

What it does

The skill applies when writing or changing Rust in the backend directory. Errors use Error from windmill_common::error with Result or JsonResult return types, library code never panics, and unwrap is reserved for compile-time guarantees. SQLx queries list columns explicitly instead of using SELECT *, which keeps older workers compatible with a newer API, use batch operations and ANY clauses to avoid N+1 queries, wrap multi-step work in transactions and parameterize everything.

For JSON it prefers a boxed RawValue over serde_json::Value unless the data is inspected or modified, and it uses serde skip_serializing_if optimizations. Async rules include spawn_blocking for CPU-heavy work, std or parking_lot mutexes unless a lock is held across await, bounded tokio mpsc channels and no thread sleep. Visibility defaults to pub(crate), API endpoints go in windmill-api, shared code in windmill-common, and rust-analyzer handles navigation. A final section on feature telemetry allowlists was cut off in the excerpt.

When your agent uses it

  • Writing a new endpoint or job handler in the Windmill backend
  • Reviewing Rust code for SQLx and error-handling conventions
  • Choosing between std and tokio mutexes in async backend code
  • Placing new code in the right crate

Example prompts

  • “Add an endpoint that lists a workspace's jobs, following the Windmill backend conventions.”
  • “Review this Rust change for SELECT * queries and N+1 patterns.”
  • “Make this CPU-heavy function safe to call from async code in the backend.”

Requirements

  • A Windmill checkout with the Rust toolchain and rust-analyzer

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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are rust).

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

  • Network

    No URLs in SKILL.md.

    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

Windmill Rust Backend Patterns loads about 869 tokens when it runs. Until then it costs about 33 tokens; SKILL.md has 236 words of instructions outside code blocks.

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

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 236 words (~869 tokens).

“Apply these Windmill-specific patterns when writing Rust code in backend/.”

— opening of SKILL.md by windmill-labs, Custom licence
name
rust-backend

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/rust-backend of windmill-labs/windmill.

Open the folder on GitHubat commit eab3dd5

Compare with similar skills

Windmill Rust Backend Patterns 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 Rust Backend Patterns compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Windmill Rust Backend Patterns this skillwindmill-labs/windmill18k—~869Automated safety check: PassCustom licence
Rust Async Patternsdiodeme/Gold-Band1439 repos~3.1kAutomated safety check: PassAGPL-3.0
Rust Engineerfarm-fe/farm5.6k1 repos~1.5kAutomated safety check: PassMIT
Mz PR ReviewMaterializeInc/materialize6.4k—~1.6kAutomated safety check: NotesCustom licence
Diesel Guardayarotsky/diesel-guard121—~3.1kAutomated safety check: PassMIT
Akka.NET Best PracticesAaronontheweb/dotnet-skills1.2k1 repos~3.3kAutomated safety check: PassMIT

Similar skills

  • Rust Async Patterns

    diodeme/Gold-Band

    Master Rust async programming with Tokio, async traits, error handling, and concurrent patterns.

    143 GitHub starsUsed in 9 repos~3.1k tokens
    DevelopmentAuto-check passed
  • Rust Engineer

    farm-fe/farm

    Writes, reviews, and debugs idiomatic Rust code with memory safety and zero-cost abstractions.

    5.6k GitHub starsUsed in 1 repo~1.5k tokens
    DevelopmentAuto-check passed
  • Mz PR Review

    MaterializeInc/materialize

    Local code review of current branch vs Materialize standards.

    6.4k GitHub stars~1.6k tokensUpdated today
    DevelopmentAuto-check: notes
  • Diesel Guard

    ayarotsky/diesel-guard

    Lints Diesel and SQLx Postgres migrations for unsafe schema changes that lock tables or cause downtime, and authors custom Rhai checks.

    121 GitHub stars~3.1k tokensUpdated 9 days ago
    DatabasesAuto-check passed
  • Akka.NET Best Practices

    Aaronontheweb/dotnet-skills

    Guidance for Akka.NET actor systems covering EventStream versus DistributedPubSub, supervision, Props versus DependencyResolver, work distribution and testable cluster code.

    1.2k GitHub starsUsed in 1 repo~3.3k tokens
    DevelopmentAuto-check passed
  • Rust Skills

    JMBeresford/retrom

    Comprehensive Rust coding guidelines with 265 rules across 26 categories.

    2.1k GitHub starsUsed in 1 repo~9.5k 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 yesterday
    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 yesterday
    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 yesterday
    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 yesterday
    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 yesterday
    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 yesterday
    Auto-check passed

Works with

Questions about Windmill Rust Backend Patterns

What does Windmill Rust Backend Patterns do?

Sets Rust conventions for the Windmill backend: error types, SQLx queries, JSON handling, async rules, module layout and rust-analyzer navigation. The skill applies when writing or changing Rust in the backend directory. Errors use Error from windmill_common::error with Result or JsonResult return types, library code never panics, and unwrap is reserved for compile-time guarantees.

When should I use Windmill Rust Backend Patterns?

Windmill Rust Backend Patterns fits situations like: writing a new endpoint or job handler in the Windmill backend; reviewing Rust code for SQLx and error-handling conventions; choosing between std and tokio mutexes in async backend code; placing new code in the right crate.

How do I install Windmill Rust Backend Patterns in Claude Code?

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

How do I install Windmill Rust Backend Patterns in Codex?

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

Can I use Windmill Rust Backend Patterns 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 rust-backend -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/rust-backend, .gemini/skills/rust-backend, .github/skills/rust-backend and .opencode/skills/rust-backend in your project.

What does Windmill Rust Backend Patterns need to run?

SKILL.md names no scripts, command-line tools or credentials: Windmill Rust Backend Patterns is instructions for the agent only. Our summary lists: A Windmill checkout with the Rust toolchain and rust-analyzer.

Does Windmill Rust Backend Patterns access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Windmill Rust Backend Patterns 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 Rust Backend Patterns use?

Windmill Rust Backend Patterns 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 Rust Backend Patterns use?

About 869 tokens (SKILL.md is roughly 3.5k 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 Rust Backend Patterns?

Skills that share tags, products or a category with Windmill Rust Backend Patterns: Rust Async Patterns (diodeme/Gold-Band, 143 stars), Rust Engineer (farm-fe/farm, 5.6k stars), Mz PR Review (MaterializeInc/materialize, 6.4k stars) and Diesel Guard (ayarotsky/diesel-guard, 121 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Windmill Rust Backend Patterns?

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.