CtrlK
BlogDocsLog inGet started
Tessl Logo

adding-a-trigger

Checklist for adding a new TriggerCrud-based trigger type to Windmill (Azure, GCP, Kafka, etc.). Use when wiring a new trigger kind across backend, frontend, CLI, and capture infrastructure.

70

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An excellent checklist-style skill: every section is a concrete, executable enumeration of exact files, symbols, and commands, sequenced 1–14 with a validation section, smoke test, and final PR checklist that fully cover this risky multi-file batch operation. The only structural improvement would be offloading the RLS deep-dive and pitfalls catalog into reference files to shorten the main body.

DimensionReasoningScore

Conciseness

The body is dense and imperative throughout — exact file paths, struct names, and commands with almost no filler, and it assumes competence (no explanations of what Kafka or migrations are). Minor trimming is possible in the RLS prose paragraph and the opening goal paragraph, so it sits at anchor 4 rather than 5's 'every token earns its place'.

4 / 5

Actionability

Fully executable guidance throughout: runnable code snippets for the router mounting and webhook wiring, exact commands ('cargo sqlx migrate add -r add_{kind}_trigger', './update_sqlx.sh', 'npm run generate-backend-client'), exact struct/trait signatures to implement, and copy-paste-ready pitfalls like '.route(path, post(h1).options(h2))'. Specific examples cover the common cases (push+pull via GCP, streaming via Kafka).

5 / 5

Workflow Clarity

A clearly sequenced 14-section checklist with reference implementations up front, per-section independence notes, a dedicated validation section with concrete commands, a UI smoke test, explicit feedback guidance ('the KINDS: [&str; N] length mismatch only surfaces when the crate compiles' → run full cargo check), and a final pre-PR checklist. This is a batch/risky operation and validation is fully covered.

5 / 5

Progressive Disclosure

No bundle files exist, and the single body is well structured with clearly signaled numbered sections and a stable {kind}/{Kind}/{KIND} convention, making it easy to navigate top-to-bottom. It does not reach 5 because all detail (the RLS policy deep-dive, the pitfalls catalog, the EE symlink workflow) is inlined in a ~280-line file where some of it could live in one-level-deep reference files.

4 / 5

Total

18

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that clearly and explicitly states both what the skill does and when to use it, with concrete provider names and natural trigger phrases in third person. Its only weaknesses are minor: a single composite action rather than enumerated capabilities, and no inline disambiguation from the closely related native-trigger skill.

DimensionReasoningScore

Specificity

The description names a concrete action ('adding a new TriggerCrud-based trigger type') and enumerates the touch surfaces ('backend, frontend, CLI, and capture infrastructure') plus named providers (Azure, GCP, Kafka). It stops short of anchor 5 because it describes one composite checklist action rather than listing multiple individual capabilities.

4 / 5

Completeness

It explicitly answers both questions: the 'what' ('Checklist for adding a new TriggerCrud-based trigger type to Windmill') and the 'when' ('Use when wiring a new trigger kind across backend, frontend, CLI, and capture infrastructure') with concrete trigger contexts, in third person. This matches the anchor 5 example structure.

5 / 5

Trigger Term Quality

Natural keywords are present ('trigger type', 'wiring', 'new trigger kind', 'Azure, GCP, Kafka', 'Windmill', 'backend, frontend, CLI') — phrases a user adding a provider trigger would actually say. A few common variations (e.g., 'add a Kafka trigger', 'Event Grid', 'subscription trigger') are missing, so it does not reach anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The scope is clearly niche (Windmill, TriggerCrud-based, named cloud providers), so it is mostly distinct with minimal conflict risk. It does not reach 5 because a sibling 'native-trigger' skill exists for the same product and the description itself does not disambiguate the boundary — that disambiguation lives in the body.

4 / 5

Total

17

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
windmill-labs/windmill
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.