CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

developing-with-bigquery

A repository of BigQuery-specific logic, knowledge, and specialized standards. Use this skill whenever you are doing anything with BigQuery, including: 1. BigQuery query optimization 2. BigFrames Python code 3. BigQuery ML/AI functions.

Quality

65%

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 ./.agents/skills/developing-with-bigquery/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

46%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 a concise, well-intentioned routing table with a couple of genuinely useful decision rules, but it contains almost no executable guidance of its own and every one of its 13 referenced resource files is missing from the bundle, making the routing unusable as shipped. Fixing the dangling references is the single highest-impact repair.

Suggestions

Ship the referenced files or fix the paths: all 13 links under resources/ (OPTIMIZATION.md, BIGFRAMES.md, BQML.md, ai-forecast.md, ai-evaluate.md, ai-generate-table.md, ai-generate-embedding.md, remote-models.md, ml-contribution-analysis.md, vector-search.md) point to files that do not exist in the bundle.

Make the mandatory data-size check executable by including the concrete method (e.g., a snippet showing how to inspect table size or row count) instead of only the directive "You MUST check the data size before deciding on which libraries to use".

Deduplicate the notebook guidance (repeated in the top IMPORTANT callout and section 4) and repair the broken inline list formatting where "- **Guide**:" and the function links are spliced mid-sentence.

DimensionReasoningScore

Conciseness

The ~45-line body is a lean routing table that assumes Claude's competence and delegates detail to per-topic guides, with useful inline rules ("Bigframes should be the default library/tool as it is more efficient than using the BigQuery Python client library"). It falls short of anchor 5 due to a redundant two-sentence self-description ("provides comprehensive guidance... acts as a routing table"), a notebook reference duplicated in both the top IMPORTANT callout and section 4, and broken inline formatting where "- **Guide**:" is spliced mid-sentence.

4 / 5

Actionability

The body's own executable guidance amounts to two high-level directives — "You MUST check the data size before deciding on which libraries to use" and making Bigframes the default — with no code, commands, or method for how to check data size, and everything else delegated to linked guides. This matches anchor 2 ('high-level hints but missing the specific steps to execute') better than anchor 3, which expects some concrete, if incomplete, executable detail in the body itself.

2 / 5

Workflow Clarity

Topic routing is unambiguous via numbered sections, and the data-size rule acts as a stated decision checkpoint, but the actual operational sequence (check data size, choose library, consult the topic guide, apply its standards) is only implied and never laid out as steps. No batch or destructive operations apply, so no cap is triggered; it sits at anchor 3 ('sequence present but checkpoints missing or implicit') rather than anchor 4's clearly sequenced workflow.

3 / 5

Progressive Disclosure

The body is structured as a clean one-level-deep routing table with well-signaled links to 13 per-topic files (OPTIMIZATION.md, BIGFRAMES.md, BQML.md, ai-forecast.md, etc.), but none of the referenced resources/ files exist in the bundle — every link dangles, so the navigation cannot actually be followed. Per the guideline to score against the actual bundle structure, this lands at anchor 2 ('minimal structure... references are buried/unusable'), noticeably below the midpoint despite the good skeleton, though not anchor 1 since there is no monolithic text or nested references.

2 / 5

Total

11

/

20

Passed

Description

70%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 solid description with an explicit 'Use when' clause, a clear BigQuery niche, and an enumerated trigger list. Its main weaknesses are the noun-based 'what' (a repository of knowledge rather than concrete actions) and missing common synonyms like BQML and BigQuery DataFrames.

Suggestions

Replace the noun-based 'what' ("A repository of BigQuery-specific logic, knowledge, and specialized standards") with concrete action verbs, e.g. "Optimize BigQuery SQL queries, generate BigFrames (BigQuery DataFrames) Python code, and write BigQuery ML/AI function SQL".

Add natural synonyms users would say, such as "BQML", "BigQuery DataFrames", and "GoogleSQL", to the trigger list.

DimensionReasoningScore

Specificity

The description names the domain ("BigQuery") and enumerates three concrete sub-areas ("query optimization", "BigFrames Python code", "BigQuery ML/AI functions"), but the framing is a noun-based "repository of BigQuery-specific logic, knowledge, and specialized standards" with no concrete action verbs. This sits above anchor 2 ('actions are minimal or generic') because the enumerated topics add real capability coverage, but below anchor 4 because nothing describes what the skill actually does with those topics.

3 / 5

Completeness

Both parts are present: a 'what' ("A repository of BigQuery-specific logic, knowledge, and specialized standards") and an explicit 'when' ("Use this skill whenever you are doing anything with BigQuery, including: 1... 2... 3..."). It does not reach anchor 5 because the 'what' is content-type description rather than concrete capabilities, and 'when' is broad ('anything with BigQuery') rather than concrete trigger phrases; it clearly exceeds anchor 3 since the 'when' clause is explicit, not merely implied.

4 / 5

Trigger Term Quality

"BigQuery" appears as the dominant natural trigger and is exactly what a user would say, supplemented by "query optimization", "BigFrames", and "ML/AI functions". Common synonyms like "BQML", "BigQuery DataFrames", and "GoogleSQL" are missing, matching anchor 4 ('good keyword coverage; a few natural terms missing') rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

BigQuery is a clear, specific niche and the trigger term is unambiguous, with deferral to '@skill:notebook-guidance' showing boundary awareness. It stops short of anchor 5 because 'whenever you are doing anything with BigQuery' is sweeping and could overlap with general Python/data-analysis or SQL skills when BigFrames or BigQuery SQL is incidental to the task.

4 / 5

Total

15

/

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 10 missing

Warning

Total

15

/

16

Passed

Repository

saski/arnesto

Path

.agents/skills/developing-with-bigquery/SKILL.md

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.