Agent skill

Windmill Trigger Type Checklist

by windmill-labs in 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.

Custom licenceAuto-check passedBackend & APIs

Install Windmill Trigger Type Checklist

skills CLI
$ npx skills add windmill-labs/windmill --skill adding-a-trigger -a claude-code

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

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

At a glance

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.

  • Works in 12 steps: Database migration → Backend crate (windmill-trigger-{kind}) → Wire into windmill-api (feature-gated… → …
  • Adding a new TriggerCrud-based trigger kind to Windmill
  • SKILL.md covers Reference implementations, 1. Database migration, 2. Backend crate… and 3. Wire into windmill-api…, plus 13 more sections
  • Calls cargo, npm and python3

What it does

The skill lists each file that has to change when a new trigger kind is added to Windmill, because missing one causes silent regressions: sync drops the trigger, the capture button does nothing, workspace forks lose it or sidebar counters undercount. It is for kinds that implement TriggerCrud, such as Kafka, GCP, Azure, MQTT, SQS, NATS, Postgres or Email. Native triggers wired through windmill-native-triggers use a different skill.

It names GCP, Kafka and Azure as reference implementations and works from the top down, starting with a database migration created by cargo sqlx migrate add -r from the backend folder, never with hand-typed timestamps. The migration defines a trigger table that mirrors the Kafka and GCP tables, indexes, a foreign key to workspace and the row-level security policies copied from an existing trigger table, with session settings wrapped in scalar sub-selects. The kind name is written in lower, Pascal and upper case throughout.

When your agent uses it

  • Adding a new TriggerCrud-based trigger kind to Windmill
  • Auditing a trigger pull request for files missed across backend, frontend and CLI
  • Wiring capture support for a new trigger type

Example prompts

  • “Add an MQTT trigger type to Windmill, following the Kafka implementation.”
  • “Check my Azure trigger branch against the new-trigger checklist and list what is missing.”
  • “Write the sqlx migration for a new NATS trigger table.”

Requirements

  • A Windmill source checkout
  • cargo with sqlx for creating migrations

Workflow steps

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

  1. Database migration
  2. Backend crate (windmill-trigger-{kind})
  3. Wire into windmill-api (feature-gated everywhere)
  4. TriggerKind enum (backend/windmill-types/src/triggers.rs)
  5. OpenAPI (backend/windmill-api/openapi.yaml)
  6. UsedTriggers + workspace export
  7. Capture infrastructure (backend/windmill-api/src/capture.rs)
  8. CLI (cli/) — easy to miss, breaks sync silently
  9. Frontend — editor + drawer
  10. Frontend — global integration
  11. Validation
  12. Common pitfalls

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:

    • cargo
    • npm
    • python3

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

  • Network

    No URLs in SKILL.md. Its commands use npm, 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

Windmill Trigger Type Checklist loads about 4.7k tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 1,843 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~52
When it runs · the whole SKILL.md, loaded when a task matches
~4.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 1,843 words (~4,694 tokens).

“Use this skill when adding a trigger kind that implements TriggerCrud (Kafka, GCP, Azure, MQTT, SQS, NATS, Postgres, Email…). For native triggers (Nextcloud, Google Drive — things wired through windmill-native-triggers), use the native-trigger skill instead.”

— opening of SKILL.md by windmill-labs, Custom licence
name
adding-a-trigger

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/adding-a-trigger of windmill-labs/windmill.

Open the folder on GitHubat commit eab3dd5

Compare with similar skills

Windmill Trigger Type Checklist 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 Trigger Type Checklist compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Windmill Trigger Type Checklist this skillwindmill-labs/windmill18k—~4.7kAutomated safety check: PassCustom licence
Heroku To AWSaws/agent-toolkit-for-aws2.8k—~7.2kAutomated safety check: PassApache-2.0
FoundatioFoundatioFx/Foundatio2.1k—~3.9kAutomated safety check: PassApache-2.0
Create Environmentgodatadriven/whirl205—~1.9kAutomated safety check: PassApache-2.0
Event Store Designwshobson/agents40k8 repos~828Automated safety check: PassMIT
Ak Cloud Deployyaalalabs/agent-kernel191—~14kAutomated safety check: PassApache-2.0

Similar skills

  • Heroku To AWS

    aws/agent-toolkit-for-aws

    Official

    Migrate workloads from Heroku to AWS. An agent skill from aws/agent-toolkit-for-aws.

    2.8k GitHub stars~7.2k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Foundatio

    FoundatioFx/Foundatio

    A skill your agent uses when working with Foundatio infrastructure abstractions for .NET -- caching, queuing, messaging, file storage, distributed locking, or background jobs.

    2.1k GitHub stars~3.9k tokensUpdated today
    Backend & APIsAuto-check passed
  • Create Environment

    godatadriven/whirl

    Create a new Whirl environment in the envs/ directory. An agent skill from godatadriven/whirl.

    205 GitHub stars~1.9k tokensUpdated 5 days ago
    Backend & APIsAuto-check passed
  • Event Store Design

    wshobson/agents

    Designs event stores for event-sourced systems: requirements, a comparison of EventStoreDB, PostgreSQL, Kafka, DynamoDB and Marten, and stream and versioning practices.

    40k GitHub starsUsed in 8 repos~828 tokens
    Backend & APIsAuto-check passed
  • Ak Cloud Deploy

    yaalalabs/agent-kernel

    Deploy an Agent Kernel project to AWS, Azure, or GCP using Terraform modules, or to any Kubernetes cluster (on-prem, baremetal, EKS) using the official Helm chart.

    191 GitHub stars~14k tokensUpdated today
    Backend & APIsAuto-check passed
  • Azure Event Hubs

    MicrosoftDocs/Agent-Skills

    Official

    Expert knowledge for Azure Event Hubs development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations &…

    775 GitHub stars~3.8k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from windmill-labs/windmill

All 42 skills in this repo
  • 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
  • Windmill Rust Backend Patterns

    windmill-labs/windmill

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

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

Questions about Windmill Trigger Type Checklist

What does Windmill Trigger Type Checklist do?

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. The skill lists each file that has to change when a new trigger kind is added to Windmill, because missing one causes silent regressions: sync drops the trigger, the capture button does nothing, workspace forks lose it or sidebar counters undercount. It is for kinds that implement TriggerCrud, such as Kafka, GCP, Azure, MQTT, SQS, NATS, Postgres or Email.

When should I use Windmill Trigger Type Checklist?

Windmill Trigger Type Checklist fits situations like: adding a new TriggerCrud-based trigger kind to Windmill; auditing a trigger pull request for files missed across backend, frontend and CLI; wiring capture support for a new trigger type.

How do I install Windmill Trigger Type Checklist in Claude Code?

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

How do I install Windmill Trigger Type Checklist in Codex?

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

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

What does Windmill Trigger Type Checklist need to run?

Going by SKILL.md and its folder, Windmill Trigger Type Checklist needs the command-line tools its instructions call (cargo, npm and python3). Our summary lists: A Windmill source checkout; cargo with sqlx for creating migrations.

Does Windmill Trigger Type Checklist access the network?

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

Is Windmill Trigger Type Checklist 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 Trigger Type Checklist use?

Windmill Trigger Type Checklist 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 Trigger Type Checklist use?

About 4.7k tokens (SKILL.md is roughly 19k 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 Trigger Type Checklist?

Skills that share tags, products or a category with Windmill Trigger Type Checklist: Heroku To AWS (aws/agent-toolkit-for-aws, 2.8k stars), Foundatio (FoundatioFx/Foundatio, 2.1k stars), Create Environment (godatadriven/whirl, 205 stars) and Event Store Design (wshobson/agents, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Windmill Trigger Type Checklist?

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.