openalex-database

Query and analyze scholarly literature using the OpenAlex database. This skill should be used when searching for academic papers, analyzing research trends, finding works by authors or institutions, tracking citations, discovering open access publications, or conducting bibliometric analysis across 240M+ scholarly works. Use for literature searches, research output analysis, citation analysis, and academic database queries.

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

68%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.

Highly actionable with comprehensive executable examples and a well-structured, real bundle, but the body is verbose for a SKILL.md overview and batch/large-scale workflows lack the explicit validation checkpoints the rubric expects.

Suggestions

Move inlined reference material (filter syntax, entity types, external IDs) into references/api_guide.md and keep SKILL.md as a concise overview, tightening conciseness toward a 4.

Add explicit validate→fix→retry checkpoints (e.g., verify batch_lookup counts and re-request missing IDs; confirm paginate_all reached max_results) to lift workflow_clarity above the batch-operation cap of 3.

Consolidate the 'Critical Best Practices' and 'Common Filter Patterns' sections into the reference files or trim to a short bullet list to reduce token overhead without losing actionability.

Dimension	Reasoning	Score
Conciseness	The body is large (~480 lines) with 12 full code-blocked capability sections plus separate 'Critical Best Practices' and 'Common Filter Patterns' sections that overlap content also held in references/api_guide.md; mostly executable specifics rather than conceptual padding, but it could be tightened by pushing reference-style detail into the existing reference files.	3 / 5
Actionability	Provides fully executable, copy-paste-ready code with concrete function signatures and parameters across the common cases (search, author/institution lookups, batch_lookup, sample_works, paginate_all, group_by), matching the 'specific examples cover the common cases' anchor.	5 / 5
Workflow Clarity	The two-step entity-lookup pattern and pagination are sequenced, but batch and large-scale operations (batch_lookup, paginate_all, sample_works >10k) lack explicit validate→fix→retry checkpoints, and troubleshooting is reactive rather than a feedback loop — the rubric's batch-operation cap holds this at 3.	3 / 5
Progressive Disclosure	Real bundle files exist (references/api_guide.md, references/common_queries.md, scripts/openalex_client.py, scripts/query_helpers.py) and are clearly signaled with one-level-deep navigation, but substantial reference-style material (filter syntax, entity types, external IDs) is inlined rather than offloaded, leaving minor organization gaps.	4 / 5
	Total	15 / 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, third-person description that clearly states what the skill does and when to use it, with comprehensive concrete actions and distinct, low-conflict triggers. The only minor gap is slightly thinner synonym coverage among trigger terms.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'searching for academic papers, analyzing research trends, finding works by authors or institutions, tracking citations, discovering open access publications...bibliometric analysis' — giving comprehensive coverage of the skill's capabilities.	5 / 5
Completeness	Explicitly answers both 'what' ('Query and analyze scholarly literature using the OpenAlex database') and 'when' with concrete trigger phrases ('This skill should be used when...', 'Use for literature searches, research output analysis, citation analysis, and academic database queries').	5 / 5
Trigger Term Quality	Good coverage of natural terms ('academic papers', 'research trends', 'citations', 'open access publications', 'literature searches', 'citation analysis'), but a few common synonyms a user might say (e.g. 'journals', 'DOIs', 'researchers') are absent, fitting the 'a few natural terms missing' anchor rather than the comprehensive anchor 5.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear niche — OpenAlex over 240M+ scholarly works — with distinct triggers ('academic database queries', 'bibliometric analysis') and minimal overlap risk with other skills.	5 / 5
	Total	19 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning

	Total	15 / 16 Passed

Repository: foryourhealth111-pixel/Vibe-Skills
Path: bundled/skills/openalex-database/SKILL.md
Commit: d5ae560

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

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.