CtrlK
BlogDocsLog inGet started
Tessl Logo

uniprot-skill

Submit compact UniProt REST API requests for UniProtKB, UniRef, UniParc, and FASTA stream endpoints. Use when a user wants concise UniProt summaries; save raw JSON or FASTA only on request.

77

Quality

96%

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.

An exemplary lean script-wrapper skill: every line is operational, the examples are copy-paste executable and verified against the actual script interface, the single-action workflow is unambiguous with an explicit failure contract, and the minimal two-file bundle is correctly referenced. No padding, no inferred-only steps, and no time-sensitive content.

DimensionReasoningScore

Conciseness

The 37-line body is entirely operational — base URL, path preferences, param conventions, stdin contract, output fields, and one runnable bash invocation — with zero explanation of concepts Claude already knows (no "what UniProt is" padding). The one repeated example JSON (Input vs Execution) serves as a runnable end-to-end command, so every line earns its place; this fits the 5 anchor, not 4 (nothing reads as over-explanation to trim).

5 / 5

Actionability

Fully executable: three copy-paste-ready JSON payloads covering search, single-accession, and FASTA-stream cases, an exact `echo ... | python scripts/rest_request.py` invocation, explicit endpoint paths (`uniprotkb/search`, `uniref/<cluster>`, `uniparc/search`, `uniprotkb/stream`), and concrete param values (`size=10`, `fields`, `response_format=text`). The common cases are covered, matching the 5 anchor.

5 / 5

Workflow Clarity

This is a single-task skill (issue one API request and return a concise summary), and the single action is unambiguous: which script to use, which paths, how to size results, when to set save_raw and report the file path instead of pasting, and how failures surface (ok=false with error.code/error.message). Per the simple-skill exception this scores 5; the operations are read-only queries, so no destructive/batch validation cap applies.

5 / 5

Progressive Disclosure

The bundle is exactly SKILL.md + scripts/rest_request.py, the body references that one script path and it exists with a matching interface (max_items, save_raw, raw_output_path, response_format, ok/error envelope), and it explicitly states no further runtime references are needed. Under the under-50-lines simple-skill guideline, the well-organized sections (Operating rules / Execution behavior / Input / Output / Execution / References) merit the 5 anchor.

5 / 5

Total

20

/

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 concise, third-person description that explicitly states both what the skill does and when to use it, with concrete domain-specific trigger terms and minimal conflict risk. The only weakness is slightly thin synonym coverage beyond the core UniProt vocabulary.

Suggestions

Add one or two natural synonyms to broaden triggering, e.g. "...for protein sequence or accession lookups" so users who say "protein sequence" or "look up accession P04637" match without reading the endpoint names.

Consider mentioning that lookups are read-only queries over the UniProt knowledgebase, which slightly widens the natural-phrases users might use when reaching for this skill.

DimensionReasoningScore

Specificity

"Submit compact UniProt REST API requests for UniProtKB, UniRef, UniParc, and FASTA stream endpoints" names the domain plus concrete capabilities across all four endpoint families, and "save raw JSON or FASTA only on request" adds a specific output behavior — comprehensive coverage in third person, matching the 5 anchor rather than 4 (no meaningful gaps for this niche).

5 / 5

Completeness

It clearly answers both: what ("Submit compact UniProt REST API requests for UniProtKB, UniRef, UniParc, and FASTA stream endpoints") and when ("Use when a user wants concise UniProt summaries"), with a concrete trigger phrase and an explicit output policy. Both clauses are explicit, matching the 5 anchor rather than 4.

5 / 5

Trigger Term Quality

Good natural-keyword coverage: "UniProt", "UniProtKB", "UniRef", "UniParc", "FASTA", "summaries" are terms users would actually say. A few natural variations are missing — e.g. "protein sequence", "protein database", or "accession" — so it sits at the 4 anchor rather than 5.

4 / 5

Distinctiveness Conflict Risk

"UniProt REST API" plus the named endpoint families define a clear niche with distinct triggers; virtually no other skill would fire on these terms, matching the 5 anchor (clear niche, minimal conflict risk).

5 / 5

Total

19

/

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