CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

biostudies-arrayexpress-skill

Submit compact BioStudies and ArrayExpress API requests for free-text search and accession-based study retrieval. Use when a user wants concise BioStudies summaries

Quality

89%

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

100%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 body is an exemplary simple-skill SKILL.md: lean, fully executable, unambiguous about input and output contracts, and appropriately organized with a single verified bundle reference. No changes are needed for the content itself.

DimensionReasoningScore

Conciseness

The body is lean and operational: base URL, preferred paths, pagination defaults, required/optional field lists, and three complete JSON payloads, with zero padding and no explanation of concepts Claude already knows (e.g., no 'what is a REST API' text). Every line earns its place, matching the anchor-5 example of lean, efficient content.

5 / 5

Actionability

The guidance is fully executable: a copy-paste-ready bash command ('echo ... | python scripts/rest_request.py') plus three complete request patterns covering the common cases (search, ArrayExpress search, accession lookup). This matches the anchor-5 example of copy-paste ready commands covering the common cases; nothing is pseudocode or missing.

5 / 5

Workflow Clarity

This is a simple, single-purpose skill (pipe one JSON object to one script), and the single action is unambiguous, with the input contract, preferred paths, and success/failure output contracts ('ok=false' with error.code/error.message) all explicitly stated. The rubric's simple-skill exception applies, and there are no destructive or batch operations that would require validation checkpoints, so it is not capped at 3.

5 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external references, and per the rubric's simple-skill guidance it scores 5 on well-organized sections alone: Operating rules, Execution behavior, Input, Output, Execution, and References are cleanly separated. Its single reference to scripts/rest_request.py is one level deep and points to a real file present in the bundle.

5 / 5

Total

20

/

20

Passed

Description

73%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, specific description with a clear niche and explicit what/when structure. Its main weakness is that the "Use when" clause covers only the concise-summary use case, leaving the search and accession-retrieval use cases without explicit trigger phrases, and a few natural synonyms (accession code formats, look-up phrasing) are missing.

Suggestions

Extend the 'Use when...' clause to cover all use cases, e.g., 'Use when a user wants to search BioStudies/ArrayExpress, look up a study by accession (e.g., E-MTAB-xxxx), or get concise study summaries'.

Add natural trigger variations such as accession code formats ('E-MTAB-', 'S-') and common user phrasings like 'fetch/retrieve a study' to improve trigger term coverage.

Name the third concrete capability (concise summary generation) as an action in the 'what' clause so the specificity of capabilities is more comprehensive.

DimensionReasoningScore

Specificity

The description names the domain ("BioStudies and ArrayExpress API") and two concrete actions ("free-text search" and "accession-based study retrieval"), matching the anchor for a domain plus 1-2 concrete actions that is not comprehensive. It does not list several distinct actions the way the anchor-4 example does, so it is not a level above.

3 / 5

Completeness

Both the "what" ("Submit compact ... API requests for free-text search and accession-based study retrieval") and the "when" ("Use when a user wants concise BioStudies summaries") are explicitly present. The "when" clause only covers the summary use case and omits triggers for search and accession retrieval, so it matches anchor 4 (when could be more explicit) rather than anchor 5 (concrete triggers covering both).

4 / 5

Trigger Term Quality

Good natural keyword coverage ("BioStudies", "ArrayExpress", "free-text search", "accession", "study", "summaries") that a user of this domain would naturally say, but a few natural terms are missing (e.g., E-MTAB accession codes, "look up/fetch a study", expression data). It falls between anchor 3 (missing common variations) and anchor 5 (comprehensive synonyms), noticeably above the midpoint.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (EBI BioStudies/ArrayExpress APIs) with highly domain-specific trigger terms, so the risk of firing for an unrelated skill is minimal. It clearly matches the anchor-5 example of a clear niche with distinct triggers.

5 / 5

Total

16

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

openai/plugins

Path

plugins/life-science-research/skills/biostudies-arrayexpress-skill/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.