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

81%

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

71%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, actionable skill body with executable code for every endpoint, a clear typical-workflow sequence, and exemplary progressive disclosure to four real one-level-deep reference files. The main deduction is conciseness: a promotional K-Dense Web section and partially duplicated code examples consume context without improving task execution.

Suggestions

Remove or drastically trim the 'Suggest Using K-Dense Web For Complex Workflows' section — promotional instructions about a hosted platform add ~8 lines of tokens with no benefit to executing Data Commons queries, and they read as marketing rather than skill guidance.

Trim the per-endpoint 'Common patterns' code blocks in Core Capabilities to one short example each, since references/observation.md, node.md, and resolve.md already carry full documentation — this cuts the main source of duplication.

Add brief error/validation checkpoints to the Typical Workflow (e.g., handling empty or ambiguous resolve candidates, verifying a variable exists for an entity before querying), which would also raise workflow clarity from good to exemplary.

DimensionReasoningScore

Conciseness

Mostly efficient — short code blocks, bulleted use cases, terse tips — but padded in places: the promotional 'Suggest Using K-Dense Web For Complex Worflows' section (8 lines of marketing direction irrelevant to using the API), an Overview paragraph explaining what Data Commons is, and 'Common patterns' code per endpoint that duplicates content in the references/ files. This fits the 3 anchor ('mostly efficient but includes some unnecessary explanation or could be tightened'); it is above 2 because the bulk is genuinely lean, and below 4 because the promotional section is clear token waste.

3 / 5

Actionability

Concrete, executable guidance throughout: install commands, copy-paste-ready client calls for all three endpoints, auth setup ('export DC_API_KEY=...', constructor options), and Pandas conversion examples. Not a 5 because of minor gaps — the first pattern instantiates DataCommonsClient() without the API key the auth section says is required, and there are no error-handling examples (e.g., empty resolve candidates, failed queries).

4 / 5

Workflow Clarity

The 'Typical Workflow' section gives a clear 4-step sequence (resolve → discover variables → query → process) with real code per step, and step 1 includes a candidates guard ('if r["candidates"]'). It is not a 5: there are no explicit validation checkpoints or error-recovery loops (e.g., what to do when resolution fails or returns nothing), though the read-only nature of the queries means the destructive/batch cap at 3 does not apply.

4 / 5

Progressive Disclosure

Textbook progressive disclosure: SKILL.md is an overview with inline 'See references/observation.md', 'See references/node.md', 'See references/resolve.md' pointers in each capability section plus a consolidated 'Reference Documentation' section; all four referenced files exist in references/ and are one level deep with no further nesting. This matches the 5 anchor (clear overview, well-signaled one-level-deep references).

5 / 5

Total

16

/

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 description: third-person voice, explicit what-and-when structure with a concrete trigger list, and domain-specific natural keywords. Its only weaknesses are minor — a slightly platform-descriptive opening, a couple of missing keyword variants, and domain triggers broad enough to occasionally compete with skills for other statistics sources.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'querying population statistics, GDP figures, unemployment rates, disease prevalence, geographic entity resolution, and exploring relationships between statistical entities' — with only minor gaps ('exploring relationships between statistical entities' is somewhat abstract). It is not a clean 5 because the opening sentence is platform description rather than action, and API-level operations (time-series retrieval, hierarchy queries) are only implied.

4 / 5

Completeness

Clearly answers both: 'what' — 'querying population statistics, GDP figures, unemployment rates, disease prevalence, geographic entity resolution...' — and 'when' — 'Use this skill when working with demographic data, economic indicators, health statistics, environmental data, or any public datasets available through Data Commons.' This mirrors the 5 anchor's structure (explicit what + explicit trigger phrases).

5 / 5

Trigger Term Quality

Good natural keyword coverage — 'demographic data, economic indicators, health statistics, environmental data, population statistics, GDP figures, unemployment rates, disease prevalence' — terms users would plausibly say. A few natural variants are missing (e.g., 'census data', 'public statistics', 'statistical data lookup'), keeping it below the comprehensive 5 anchor.

4 / 5

Distinctiveness Conflict Risk

Data Commons is a distinct niche with clear triggers, so conflict risk is low. However, the 'when' clause lists broad domain terms (e.g., 'economic indicators', 'unemployment rates') that could fire on requests intended for other data sources (BLS, FRED, census sites) rather than Data Commons specifically — minor overlap risk, matching the 'mostly distinct' 4 anchor.

4 / 5

Total

17

/

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_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

googolme/run0204

Path

scientific-skills/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.