CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bigquery-public

Run read-only SQL against BigQuery public datasets with local result capture, cost safeguards, and reproducibility outputs.

Quality

71%

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

Quality

Content

61%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 content is well structured with a strong, concrete CLI reference and clearly documented safety defaults and output layout, making it immediately usable for the common cases. Its weaknesses are triplicated pipeline descriptions across three sections, a workflow lacking error-recovery feedback loops for a database-operation skill, and CLI commands that point at a script not present in the bundle.

Suggestions

Merge "Core Capabilities", "Workflow", and "Algorithm / Methodology" into a single section, keeping one pass over the pipeline plus the key parameters.

Add explicit error-recovery checkpoints (e.g., "If validation rejects the query, rewrite as SELECT-only and re-validate"; "If ADC is unavailable, fall back to `bq` and re-run") to the Workflow.

Ship the referenced `bigquery_public.py` in a scripts/ directory (or fix the path) so the CLI Reference commands are executable from the skill bundle as written.

DimensionReasoningScore

Conciseness

The body is mostly efficient but repeats the same pipeline three times across "Core Capabilities", "Workflow", and "Algorithm / Methodology" (validate read-only SQL, auth ADC-then-bq, safeguards, persist outputs), and sections like "Why This Exists" and "Integration with Bio Orchestrator" add little operational value. This fits the 3 anchor ('could be tightened with some unnecessary explanation') rather than 2, since nothing explains concepts Claude already knows and there is no heavy padding; it falls short of 4 because the triple duplication is more than a minor trim.

3 / 5

Actionability

The CLI Reference gives concrete, complete, copy-paste-ready commands with flags and output paths for the common cases (inline SQL, .sql file, preview, list-tables, describe, demo), matching the 5 anchor's coverage but with a real gap: the referenced script `bigquery_public.py` (and `clawbio.py`) is not present in any scripts/ or references/ bundle directory, so the commands are not executable as-is from the skill. That missing key detail places it at the 4 anchor ('mostly executable, concrete commands with minor gaps') rather than 5.

4 / 5

Workflow Clarity

The Workflow lists a clear sequence (Validate → Authenticate → Execute → Discover → Generate) with a read-only validation step and dry-run safeguard, but there are no feedback loops for error recovery (what to do when validation rejects a query or auth fails), and "Discover" is oddly ordered after "Execute" despite being for inspecting schema "before writing SQL". For a database-operation skill, the scoring notes cap workflow_clarity at 3 when feedback loops are missing, and the 3 anchor (sequence present, checkpoints missing or implicit) fits better than 4.

3 / 5

Progressive Disclosure

The single SKILL.md is well organized into clearly signaled sections (Workflow, CLI Reference, Output Structure, Dependencies, Safety) with no nested reference chains, and the only outbound links (Citations) are one level deep — matching the 4 anchor of good structure with minor gaps. It does not reach 5 because a script path (`skills/bigquery-public/bigquery_public.py`) is referenced but no bundle directory exists to hold it, and some inline reference material (full CLI catalog, output tree) could live in a separate file if the skill grows.

4 / 5

Total

14

/

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.

The description is specific and clearly differentiated, naming the BigQuery public-data niche with several concrete capabilities in third person without padding. Its main weakness is the absence of any 'Use when...' trigger clause, which leaves the activation conditions implicit.

Suggestions

Append an explicit trigger clause, e.g. "Use when the user mentions BigQuery, public datasets, querying public data, or running SQL against bigquery-public-data."

Ground the abstract nouns ("cost safeguards", "reproducibility outputs") in the concrete artifacts the skill produces, e.g. "writes report.md, result.json, and a CSV of results with job metadata".

Add a natural synonym or two ("BigQuery SQL", "query public data") to broaden the trigger phrases.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Run read-only SQL against BigQuery public datasets", "local result capture", "cost safeguards", "reproducibility outputs" — which matches the 'several specific actions; minor gaps' anchor. It falls short of the 5 anchor because "cost safeguards" and "reproducibility outputs" stay abstract rather than naming what is actually produced (e.g., report.md, result.json), and it is above 3 because it goes well beyond naming a domain with one or two actions.

4 / 5

Completeness

The "what" is clear (run read-only SQL against BigQuery public datasets with local outputs, cost limits, and reproducibility), but there is no "Use when..." clause or equivalent explicit trigger guidance — the "when" is only weakly implied by the domain itself. Per the judging guidelines, a missing 'Use when...' clause caps completeness at 3, which also fits the 3 anchor ('clear what, when missing or only weakly implied') better than the 4 anchor ('both present').

3 / 5

Trigger Term Quality

"BigQuery public datasets", "read-only SQL", and "SQL" are natural terms users would say, giving good keyword coverage per the 4 anchor. It misses common variations and synonyms ("query public data", "BigQuery SQL", "bq"), so it does not reach the comprehensive 5 anchor; it is clearly above the 3 anchor, which is characterized by relevant-but-thin keyword sets.

4 / 5

Distinctiveness Conflict Risk

"Run read-only SQL against BigQuery public datasets" carves out a clear niche with distinct triggers (BigQuery, public datasets, read-only SQL) and minimal conflict risk with other data or SQL skills. It matches the 5 anchor squarely; the read-only/public-data scoping further separates it from generic database skills.

5 / 5

Total

16

/

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

metadata_field

'metadata' should map string keys to string values

Warning

Total

15

/

16

Passed

Repository

ClawBio/ClawBio

Path

skills/bigquery-public/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.