CtrlK
BlogDocsLog inGet started
Tessl Logo

update-sqlx

How to safely update SQLx offline query cache. MUST use when SQL queries change.

72

Quality

87%

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

100%

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

The body is a tight, highly actionable runbook with executable commands, a numbered workflow, and explicit validation for a destructive cache operation. It earns top marks across all content dimensions with no real weaknesses.

DimensionReasoningScore

Conciseness

The body is lean operational guidance focused on non-obvious gotchas (EE cache deletion, SQLX_OFFLINE CI behavior) rather than basics Claude already knows, so every section earns its place; not 2 because there is no padded conceptual explanation to tighten.

3 / 3

Actionability

The Safe Procedure provides fully executable, copy-paste-ready bash (git checkout, cargo sqlx prepare, find/awk/comm, git show) with specific flags and paths, matching the 'fully executable code/commands' anchor; not 2 because the commands are complete rather than pseudocode.

3 / 3

Workflow Clarity

Steps are explicitly numbered 1-4 with an embedded validation checkpoint in step 4 ("Should output: 0") plus a post-commit Verification section, satisfying the 'clear sequence with explicit validation steps' anchor for a destructive operation; not 2 because validation is present, not implicit.

3 / 3

Progressive Disclosure

The skill is a single cohesive runbook with well-organized sections and no nested external references, which is appropriate for this one-procedure content with no bundle files; not 2 because nothing here would be improved by being split into a separate reference file.

3 / 3

Total

12

/

12

Passed

Description

75%

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 compact and answers both what and when with an explicit trigger, with a clearly distinctive niche. Its main weakness is limited trigger-term coverage and a single named action rather than a comprehensive action list.

Suggestions

Add one or two more concrete actions (e.g., 'regenerate OSS caches and restore EE caches') to lift specificity toward the multi-action anchor.

Broaden trigger terms to cover natural phrasings users might say, such as 'when sqlx prepare fails in CI' or 'after editing sqlx::query! macros'.

DimensionReasoningScore

Specificity

It names a concrete domain ("SQLx offline query cache") and a single action ("safely update"), but does not list multiple distinct concrete actions, matching the 'names domain and some actions, but not comprehensive' anchor.

2 / 3

Completeness

It states both what ("How to safely update SQLx offline query cache") and an explicit when ("MUST use when SQL queries change"), satisfying the 'clearly answers both what AND when with explicit triggers' anchor; not below because the trigger clause is explicit rather than implied.

3 / 3

Trigger Term Quality

The phrase "MUST use when SQL queries change" supplies one relevant, fairly natural trigger, but coverage of variations is thin and "SQLx offline query cache" leans toward jargon, fitting 'some relevant keywords but missing common variations'.

2 / 3

Distinctiveness Conflict Risk

"SQLx offline query cache" is a narrow, distinctive niche unlikely to collide with unrelated skills, matching the 'clear niche with distinct triggers' anchor; not 2 because the domain is specific rather than broadly overlapping.

3 / 3

Total

10

/

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.