CtrlK
BlogDocsLog inGet started
Tessl Logo

sql-reporting

Conventions and review steps for writing analytics SQL against the warehouse. Use whenever the task involves querying tables, building a report, or aggregating metrics.

72

Quality

90%

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

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

A lean, well-organized, single-purpose skill body: every token is prescriptive rather than explanatory, the review checklist provides an explicit validation checkpoint before returning results, and the short length needs no external reference files. The only gap is the absence of a worked example query, which keeps actionability at 4 rather than 5.

DimensionReasoningScore

Conciseness

The ~35-line body is pure prescriptive guidance — conventions, a checklist, and an output format — with no explanation of concepts Claude already knows (e.g., it never explains what SQL or aggregation is) and no padding. This matches the anchor 'lean and efficient; assumes Claude's competence; every token earns its place'; a 4 would require minor instances of over-explanation, which are absent.

5 / 5

Actionability

Concrete, immediately executable rules like "Always SELECT explicit column names, never SELECT *", "Alias aggregates with snake_case names (order_count, not count(*))", and the fenced ```sql output format match 'mostly executable guidance; concrete code or commands with minor gaps'. It falls short of 5 because there is no worked example query, though the scoring note confirms absence of code in an instruction-only skill is not penalized when guidance is this actionable.

4 / 5

Workflow Clarity

For this simple single-purpose skill the sequence is unambiguous: apply the conventions, run the "Review Checklist (run before returning an answer)" as an explicit validation checkpoint, then produce the specified output. The explicit pre-return checklist matches the simple-skill exception and provides the validation step anchors look for; a 4 would require that checkpoint be merely implicit.

5 / 5

Progressive Disclosure

Per the guideline that skills under 50 lines with no need for external references can score 5 with just well-organized sections, the body's clean sections (When to Use, Conventions, Review Checklist, Output Format) qualify — there are no buried or nested references (no bundle files exist at all). It is not below 5 since there is no inlined content that belongs in a separate file.

5 / 5

Total

19

/

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 third-person description that clearly states both what the skill provides and when to use it, with natural trigger phrases. The main room for improvement is broader trigger synonym coverage and slightly more distinct phrasing to reduce overlap with generic data-analysis skills.

DimensionReasoningScore

Specificity

The description lists several concrete, domain-anchored actions — "writing analytics SQL against the warehouse", "querying tables", "building a report", "aggregating metrics" — comparable to the anchor 'lists several specific actions; minor gaps in coverage'. It falls short of a 5 because it never names what the conventions actually cover (e.g., SELECT hygiene, partition filtering), which is a minor coverage gap.

4 / 5

Completeness

It explicitly answers both parts with concrete trigger phrases: the 'what' ("Conventions and review steps for writing analytics SQL against the warehouse") and the 'when' ("Use whenever the task involves querying tables, building a report, or aggregating metrics"), matching the anchor 5 example structure. A 4 would require the 'when' to be less explicit or specific, which is not the case here.

5 / 5

Trigger Term Quality

Natural user phrasings like "querying tables", "building a report", and "aggregating metrics" give good keyword coverage, matching the anchor 'good keyword coverage; a few natural terms missing'. Not a 5: common variations users would say — "write a SQL query", "dashboard", "metrics query", warehouse name — are absent.

4 / 5

Distinctiveness Conflict Risk

The niche (analytics SQL against a warehouse) is mostly distinct with clear triggers, matching the anchor 'mostly distinct; minor overlap risk'. It is not a 5 because generic phrases like "building a report" and "aggregating metrics" could plausibly overlap with general data-analysis or BI skills.

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
apache/airflow
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.