CtrlK
BlogDocsLog inGet started
Tessl Logo

write-script-bigquery

MUST use when writing BigQuery queries.

59

Quality

67%

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

Fix and improve this skill with Tessl

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

Quality

Content

85%

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 commands and complete SQL examples, a clear intent-driven workflow with explicit validation and feedback loops, and well-organized self-contained sections. Its main weakness is conciseness: several prose passages over-qualify edge cases in long run-on sentences that could be tightened.

DimensionReasoningScore

Conciseness

The body is dense with commands and executable examples and avoids explaining concepts Claude already knows, but several prose passages (notably the metadata-sync paragraph) are long run-on sentences with heavy edge-case qualification that could be tightened, matching 'mostly efficient but could be tightened.'

2 / 3

Actionability

It provides fully executable wmill commands with flags and concrete, copy-paste-ready SQL examples for @name parameters, S3Object ingestion via JSON_EXTRACT_ARRAY/JSON_VALUE, and a -- s3 streaming directive, matching 'fully executable code/commands; copy-paste ready.'

3 / 3

Workflow Clarity

It sequences a clear intent-driven decision flow (preview vs run vs sync push) with explicit validation checkpoints — diff regenerated locks, report dependency version bumps before deploying, and --dry-run to preview stale items — including a feedback loop for error recovery, matching 'clear sequence with explicit validation steps; feedback loops.'

3 / 3

Progressive Disclosure

With no bundle files present, the single-purpose skill is organized into clear, well-signaled sections and one-level-deep external pointers (AGENTS.wmill.md, the preview skill), so it scores 3 per the simple-skill guideline for well-organized, self-contained content.

3 / 3

Total

11

/

12

Passed

Description

50%

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 short and explicit about its trigger (writing BigQuery queries) but fails to articulate concrete capabilities or a fuller set of natural trigger terms, leaving the 'what' weak. It is distinguishable mainly by naming BigQuery specifically but risks overlap with generic SQL skills.

Suggestions

Add a brief list of concrete capabilities to the description, e.g. 'Write BigQuery queries with @name parameters, accept S3Object arguments, and stream results to S3.'

Expand trigger terms with natural variations users say, such as 'BigQuery', 'BigQuery SQL', 'BQ', and 'BigQuery scripts'.

Separate the 'what' from the 'when' so the description clearly states what the skill does plus a 'Use when...' clause, e.g. 'Write and run BigQuery scripts in Windmill: parameterize with @name, accept S3Object args, stream results to S3. Use when writing or testing BigQuery queries.'

DimensionReasoningScore

Specificity

The description names a concrete domain and action ("writing BigQuery queries") but lists only a single action rather than multiple specific concrete capabilities, matching the 'names domain and some actions, but not comprehensive' anchor.

2 / 3

Completeness

It provides an explicit 'when' trigger ("MUST use when writing BigQuery queries") but the 'what does this do' is only weakly implied by restating the trigger, so it does not clearly answer both halves and caps at 2.

2 / 3

Trigger Term Quality

"writing BigQuery queries" includes the natural terms "BigQuery" and "queries" a user might say, but coverage is thin and omits common variations (SQL, BQ, BigQuery script), matching 'some relevant keywords but missing common variations.'

2 / 3

Distinctiveness Conflict Risk

The BigQuery-specific niche and explicit 'MUST use' trigger distinguish it somewhat, but it could still overlap with a generic SQL-query-writing skill, matching 'somewhat specific but could still overlap with similar skills.'

2 / 3

Total

8

/

12

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.

Validation16 / 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.