CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

encode-skill

Submit compact ENCODE REST API requests for object lookups, portal-style search, and metadata retrieval. Use when a user wants concise ENCODE summaries

72

Quality

91%

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 skill body: every line is an operational directive or executable example, the input/output contract is fully specified and consistent with the bundled script, and structure is appropriately minimal for a single-purpose tool. No material weaknesses found.

DimensionReasoningScore

Conciseness

The ~35-line body is entirely operational directives — rules, input schema, output schema, one runnable command — with zero explanation of concepts Claude already knows (e.g., 'Treat displayed `...` in tool previews as UI truncation' is non-obvious, earned guidance). Not a 4 because nothing needs trimming: the repeated search payload appears once as an input pattern and once inside the full executable command, each serving a distinct purpose.

5 / 5

Actionability

Fully executable: a copy-paste-ready `echo ... | python scripts/rest_request.py` command, a complete list of required/optional input fields, two concrete JSON payloads for the common cases (object lookup and search), and a precise output contract ('ok', 'records', 'error.code', 'error.message'). The documented interface matches the actual `scripts/rest_request.py` implementation. Not a 4 because no key execution detail is missing.

5 / 5

Workflow Clarity

This is a simple single-task skill (issue one API request) and the single action is unambiguous: build the JSON input per the documented fields, run the script, interpret success vs. 'ok=false' with 'error.code'/'error.message', and use 'save_raw=true' for full payloads. The failure-output contract plus rules like 'Re-run requests in long conversations' provide the needed checkpoints; the destructive/batch validation cap does not apply since these are read-only lookups.

5 / 5

Progressive Disclosure

Under 50 lines with no need for external reference files, and the body explicitly states 'No additional runtime references are required; keep the import package limited to this file and scripts/rest_request.py' — which accurately matches the actual bundle (SKILL.md plus the single script). Sections (Operating rules, Execution behavior, Input, Output, Execution, References) are well-organized and flat, so the simple-skill exception applies cleanly.

5 / 5

Total

20

/

20

Passed

Description

78%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: concrete, third-person, domain-specific, with an explicit 'Use when...' trigger clause. The main improvement would be broadening the 'when' clause to cover lookups/searches and adding a few more natural trigger terms like 'accession' or 'encodeproject.org'.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'object lookups, portal-style search, and metadata retrieval' — plus a specific mechanism ('Submit compact ENCODE REST API requests'), with minor gaps (e.g., no mention of fetching raw data files or which object types). Not a 5 because coverage is not comprehensive, and not a 3 because it names the domain and multiple specific actions rather than just 1-2.

4 / 5

Completeness

Both parts are present: 'what' is clear ('Submit compact ENCODE REST API requests for object lookups, portal-style search, and metadata retrieval') and 'when' is explicit ('Use when a user wants concise ENCODE summaries'). Not a 5 because the 'when' clause covers only the summary use case and misses the lookup/search triggers; not a 3 because no 'Use when...' clause is missing.

4 / 5

Trigger Term Quality

Good natural-keyword coverage: 'ENCODE', 'search', 'lookups', 'metadata', 'concise ENCODE summaries' are phrases users would plausibly say. Not a 5 because common variations are missing ('encodeproject.org', 'accession', 'experiment', 'biosample'), and not a 3 because coverage goes well beyond a single generic keyword.

4 / 5

Distinctiveness Conflict Risk

ENCODE is a distinct, named data portal with clear niche triggers; the description would not plausibly fire for unrelated skills. Third-person voice is used throughout, so no voice penalty applies.

5 / 5

Total

17

/

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