write-script-snowflake

MUST use when writing Snowflake queries.

Quality

59%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./system_prompts/auto-generated/skills/write-script-snowflake/SKILL.md

Quality

Content

75%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 Windmill/Snowflake operational guidance with executable commands and SQL examples, strong on actionability and reasonably well-structured. Its main weakness is verbosity in the metadata-sync explanation and a workflow that, while clear, is spread across sections rather than consolidated into one sequenced checklist.

Dimension	Reasoning	Score
Conciseness	Most content is efficient and Windmill-specific, but the metadata-sync section and repeated deploy-vs-run disclaimers run long and could be tightened, fitting the anchor for mostly efficient with some unnecessary explanation.	3 / 5
Actionability	Concrete executable commands (wmill script preview/run, generate-metadata, rehash, --dry-run) and copy-paste SQL examples for ?-binding, S3Object via PARSE_JSON/LATERAL FLATTEN, and the -- s3 directive cover the common cases fully.	5 / 5
Workflow Clarity	Intent-based routing (preview vs run vs sync push) with preview-as-validation before any deploy is a clear sequence with most checkpoints present; it is scattered across sections rather than one numbered checklist, leaving a minor validation-organization gap.	4 / 5
Progressive Disclosure	A single well-sectioned file with clear headers (CLI Commands, Snowflake, S3Object, streaming) and a one-level pointer to AGENTS.wmill.md; no nested references, though slightly above the under-50-line simple-skill threshold and the external pointer is not part of the skill bundle.	4 / 5
	Total	16 / 20 Passed

Description

43%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 a clear, distinct trigger but tells Claude almost nothing about what the skill actually does beyond 'writing Snowflake queries', omitting the Windmill scripting context that defines the skill. It reads as a trigger clause with the explanatory half missing.

Suggestions

State what the skill does concretely, e.g. 'Writes, previews, and syncs Windmill Snowflake scripts using the wmill CLI, including ?-parameter binding and S3 result streaming.'

Expand trigger terms to include synonyms users actually say: 'Snowflake queries', 'Snowflake SQL', 'Windmill Snowflake script'.

Keep the explicit 'Use when...' clause but pair it with the 'what' so both halves are present.

Dimension	Reasoning	Score
Specificity	The description only names the domain ("writing Snowflake queries") with no concrete actions or capabilities described, matching the anchor that names a domain but offers minimal/generic action.	2 / 5
Completeness	It provides a clear trigger ("MUST use when writing Snowflake queries") but no real 'what' — the skill actually concerns Windmill script authoring, previewing, and metadata sync, none of which is stated, so only 'when' is present without 'what'.	2 / 5
Trigger Term Quality	"Snowflake queries" is a natural phrase a user would say, but coverage is thin with no synonyms or file-extension variants, fitting the anchor for some relevant keywords missing common variations.	3 / 5
Distinctiveness Conflict Risk	The Snowflake-specific trigger carves a clear niche with minimal overlap risk against other skills, matching the anchor for a distinct trigger with minimal conflict.	5 / 5
	Total	12 / 20 Passed

Validation

100%

Warnings & errors only

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
Path: system_prompts/auto-generated/skills/write-script-snowflake/SKILL.md
Commit: 74af4ed

Reviewed: about 18 hours ago

Table of Contents

Discovery Implementation Validation

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.