CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

datacommons-client

Work with Data Commons, a platform providing programmatic access to public statistical data from global sources. Use this skill when working with demographic data, economic indicators, health statistics, environmental data, or any public datasets available through Data Commons. Applicable for querying population statistics, GDP figures, unemployment rates, disease prevalence, geographic entity resolution, and exploring relationships between statistical entities.

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

78%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 well-structured, highly actionable overview: copy-paste-ready Python for all three endpoints, a clear typical-workflow sequence, authentication details, and clean progressive disclosure into four real, substantive reference files. The main cost is token duplication — resolve/observation snippets appear in both the capability sections and the workflow section, and the tips list repeats navigation already given elsewhere — plus missing validation checkpoints in the workflow (e.g., handling empty resolve candidates).

Suggestions

Deduplicate the resolve/observation code between 'Core Capabilities' and 'Typical Workflow' — show the pattern once and let the workflow reference it, cutting roughly 30 lines from the body.

Trim 'Tips for Effective Use' items that restate other sections (e.g., tip 7 duplicates the Reference Documentation section; tip 5 about caching resolutions is vague without a snippet).

Add a validation checkpoint in 'Typical Workflow' step 1 — e.g., what to do when a name resolves to no candidates or ambiguous candidates — so the workflow has an explicit error path.

DimensionReasoningScore

Conciseness

The body is mostly efficient (terse endpoint summaries, no filler explanations of concepts Claude already knows), but it could be tightened: the resolve and observation code is duplicated between 'Core Capabilities' and 'Typical Workflow', and tip 7 ('Read reference docs') restates the Reference Documentation section. This lands on 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the level-4 'minor instances'.

3 / 5

Actionability

Every section gives copy-paste-ready, complete Python: install commands ('uv pip install "datacommons-client[Pandas]"'), client construction, per-endpoint fetch calls with real arguments, auth via 'export DC_API_KEY=...'', and result processing ('response.to_observations_as_records()', pivot example). This matches the level-5 anchor of fully executable examples covering the common cases, exceeding level 4 ('minor gaps').

5 / 5

Workflow Clarity

The 'Typical Workflow' section gives a clear four-step sequence (resolve → discover variables → query → process) and 'Tips for Effective Use' reinforces ordering ('Always start with resolution'). It is not a 5 because validation checkpoints are implicit only — e.g., the workflow never checks for empty 'candidates' or unavailable variables — placing it at 'clear sequence with most checkpoints present; minor validation gaps' rather than the level-5 explicit validate/feedback-loop pattern. The destructive/batch cap does not apply since all operations are read-only queries.

4 / 5

Progressive Disclosure

The body is an overview that points to four real, substantive, one-level-deep reference files (references/observation.md, node.md, resolve.md, getting_started.md — all present in the bundle), each clearly signaled both inline ('See references/observation.md for comprehensive documentation') and in a consolidated 'Reference Documentation' section. This matches the level-5 anchor of a clear overview with well-signaled one-level-deep references and easy navigation; the inlined common patterns are appropriately brief.

5 / 5

Total

17

/

20

Passed

Description

92%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 description: it states what the skill does, gives an explicit 'Use this skill when...' trigger clause with concrete data domains, and lists specific queryable statistics and entity-resolution capabilities. The only weakness is modest synonym coverage (e.g., 'census data', 'statistical data') that would widen natural-language triggering.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions — 'querying population statistics, GDP figures, unemployment rates, disease prevalence, geographic entity resolution, and exploring relationships between statistical entities' — which comprehensively cover the skill's three endpoints (query, resolve, explore). It sits above the level-4 anchor ('several specific actions; minor gaps') because the enumerated actions span the full capability surface rather than leaving gaps.

5 / 5

Completeness

It explicitly answers 'what' ('programmatic access to public statistical data from global sources') and 'when' with a literal trigger clause: 'Use this skill when working with demographic data, economic indicators, health statistics...'. This matches the level-5 anchor: both what and when stated with concrete trigger phrases, so it is not the level-4 'when could be more explicit' case.

5 / 5

Trigger Term Quality

Natural user phrases like 'demographic data, economic indicators, health statistics, environmental data' and 'unemployment rates' provide good keyword coverage. Not a 5: common synonyms such as 'census data', 'statistical data', or 'public data' variations are missing, keeping it at 'good coverage; a few natural terms missing' rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

The Data Commons platform name and the scoping phrase 'any public datasets available through Data Commons' establish a clear niche. Trigger domains (demographics, GDP, disease prevalence) are generic-ish, but they are anchored to the named platform, minimizing conflict risk with other skills — matching the level-5 'clear niche with distinct triggers'.

5 / 5

Total

19

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

synthetic-sciences/openscience

Path

backend/cli/skills/databases/datacommons-client/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.