CtrlK
BlogDocsLog inGet started
Tessl Logo

write-script-bunnative

MUST use when writing Bun Native scripts. The script must start with //native to run on the native worker.

55

Quality

63%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./system_prompts/auto-generated/skills/write-script-bunnative/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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.

The body is highly actionable with executable code and specific CLI commands, and its operational guidance (preview vs run by intent, metadata sync with diff/dry-run feedback loops) is clear and high-signal. Its main weakness is structure: a large inlined API reference and no bundle files mean progressive disclosure is poor and the token budget is heavier than it needs to be.

Suggestions

Move the ~610-line windmill-client API reference (lines 172-783) into a separate REFERENCE.md bundle file and keep only a few key examples plus a pointer in SKILL.md.

Present the write -> preview -> generate-metadata -> deploy flow as a short numbered checklist with an explicit 'validate (preview) before deploy' checkpoint.

Give the deploy step a concrete command example (git push vs wmill sync push) instead of only a prose description.

DimensionReasoningScore

Conciseness

The CLI/operational prose is tight and high-signal (no padding with concepts Claude already knows), but a roughly 610-line inlined windmill-client API reference with full JSDoc for every function is a substantial token cost that could be tightened or moved out, fitting 'mostly efficient but includes some unnecessary [bulk] or could be tightened' rather than the lean level above.

3 / 5

Actionability

Code examples (//native main, RT.Stripe, fetch, S3 load/write) and CLI commands (wmill script preview, generate-metadata with --dry-run) are executable and copy-paste ready with specific flags and signatures, but the deploy step is only described abstractly ("via git push or wmill sync push") and some SDK entries lack usage examples, leaving minor gaps that cap it at 'mostly executable guidance'.

4 / 5

Workflow Clarity

There is a clear sequence (write -> offer/preview -> generate-metadata -> deploy) with real validation checkpoints and a feedback loop (preview validates before deploy, generate-metadata --dry-run lists stale items, diff the .lock to catch unwanted version bumps), but it is delivered as prose decision rules rather than a crisp numbered checklist with explicit validate steps, so it does not reach the level-5 checklist anchor.

4 / 5

Progressive Disclosure

Section headers (## / ###) give real structure and external references (AGENTS.wmail.md, rt.d.ts, the preview skill) are signaled, but there are no bundle files at all and the entire ~610-line SDK API reference is inlined in SKILL.md — exactly 'content that should be separate is inline' — so it sits at 'some structure but could be better organized' rather than the well-split level above.

3 / 5

Total

14

/

20

Passed

Description

62%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.

The description is concise, uses third person, and explicitly pairs a trigger clause with a concrete behavioral requirement, giving it solid completeness and distinctiveness. Its weakness is limited breadth — only one concrete action and thin synonym/extension coverage — which keeps specificity and trigger-term quality at the middle of the scale.

Suggestions

Add 1-2 more concrete capabilities (e.g. importing npm packages/relative scripts, using windmill-client for Windmill calls) so the 'what' reflects the skill's full scope rather than only the //native constraint.

Include natural synonyms and file extensions in the description (TypeScript, .ts, native worker) to broaden trigger-term coverage.

Keep the explicit 'MUST use when writing Bun Native scripts' trigger — it is the strongest part of the description.

DimensionReasoningScore

Specificity

The description names the domain ("writing Bun Native scripts") and one concrete requirement ("The script must start with //native"), but only states a single action/constraint rather than several, so it fits the '1-2 concrete actions, not comprehensive' anchor and not the 'several specific actions' level above.

3 / 5

Completeness

It explicitly answers both: 'when' via "MUST use when writing Bun Native scripts" and 'what' via "The script must start with //native to run on the native worker". Both are present and concrete, but the 'what' is narrow (only the //native constraint, not the full capability set), so it sits at 'has both what and when' rather than the comprehensive level 5.

4 / 5

Trigger Term Quality

"writing Bun Native scripts" is a relevant natural trigger phrase a user would say, but coverage lacks common synonyms and file extensions (TypeScript, .ts, native worker scripts), matching the 'some relevant keywords but missing common variations' anchor.

3 / 5

Distinctiveness Conflict Risk

"Bun Native scripts" with the //native marker is a clear, fairly distinct niche with minimal conflict risk, though there is minor overlap with a regular Bun script skill (the body itself notes the same script runs on the regular worker without //native), placing it at 'mostly distinct; minor overlap risk'.

4 / 5

Total

14

/

20

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (783 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

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.