CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

literature-search-openalex

Query the OpenAlex scholarly database for research papers, authors, institutions, topics, sources, publishers, funders, geo-locations, and keywords. Use when searching academic papers, resolving DOIs, downloading open-access PDFs, finding an author's publications, aggregating bibliometric data (citation counts, h-index, impact factor), exploring the research taxonomies, or performing DOI lookups.

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

82%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 skill body is a well-structured operational reference: executable commands, cost/rate-limit tables, concrete workflows, and a disciplined error-handling section with feedback loops. Remaining improvements are small — deduplicating the rate-limit and credentials guidance, adding verification for batch lookups, and linking the orphaned citation.bib.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence (no explanations of what scholarly databases or APIs are), but rate-limit/budget facts are stated twice (Prerequisites item 4 and the Rate Limits section) and the credentials-skill protocol is repeated in five places — 'minor instances of over-explanation that could be trimmed' per the 4 anchor, short of the 5 anchor's every-token-earns-its-place.

4 / 5

Actionability

Fully executable throughout: complete 'uv run scripts/openalex_cli.py …' invocations, per-flag documentation for every command, and five copy-paste-ready workflow blocks (resolve→filter with jq slimming, DOI lookup, bulk DOI lookup, group-by aggregation, seeded sampling). This matches the 5 anchor's 'copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

Sequencing is explicit (the 'Resolve before filter' rule and demonstrated resolve→filter workflows), PDF downloads carry a verification step ('verify any downloaded PDF is non-empty and not corrupted'), and the error table gives per-code actions with a retry-vs-do-not-retry distinction. It falls short of the 5 anchor because the bulk DOI lookup and sampling workflows lack verification checkpoints, matching the 4 anchor's 'clear sequence with most checkpoints present'.

4 / 5

Progressive Disclosure

The body is a genuine overview — core CLI usage inline, per-entity filter/sort/group-by fields split into ten clearly-signaled, one-level-deep references/*.md links that all resolve to real files. The 4 (not 5) applies because references/citation.bib exists in the bundle but is never referenced or explained anywhere in the body, a minor navigation gap.

4 / 5

Total

17

/

20

Passed

Description

96%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 a strong example: concrete third-person capability listing, an explicit 'Use when' clause with natural trigger phrases and synonyms, and a clearly identified data source. Its only weakness is mild overlap risk with other academic-literature search skills on generic triggers like 'searching academic papers'.

DimensionReasoningScore

Specificity

Lists multiple concrete actions in third person — 'Query the OpenAlex scholarly database for research papers, authors, institutions, topics, sources, publishers, funders', 'resolving DOIs, downloading open-access PDFs, aggregating bibliometric data (citation counts, h-index, impact factor)' — matching the comprehensive-coverage anchor; it sits clearly above the 4 anchor, which expects minor gaps in coverage.

5 / 5

Completeness

Explicitly answers both questions: 'what' via 'Query the OpenAlex scholarly database for research papers, authors, …' and 'when' via 'Use when searching academic papers, resolving DOIs, …' with concrete trigger phrases — the exact pattern of the 5 anchor; the 4 anchor's weaker/'could be more explicit' when-clause does not apply.

5 / 5

Trigger Term Quality

Covers the natural phrases users would say — 'searching academic papers', 'downloading open-access PDFs', 'finding an author's publications', 'h-index', 'impact factor' — plus the synonym pair 'resolving DOIs' / 'performing DOI lookups'. Coverage is comprehensive with synonyms, fitting the 5 anchor rather than the 4 anchor's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

The OpenAlex/bibliometric niche with DOI-resolution triggers is mostly distinct, but 'searching academic papers' and 'finding an author's publications' would also naturally trigger closely related scholarly-search skills (e.g., arXiv or PubMed skills), matching the 4 anchor's 'minor overlap risk with closely related skills' rather than the 5 anchor's minimal conflict risk.

4 / 5

Total

19

/

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

google-deepmind/science-skills

Path

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