rcsb-pdb-skill

Submit compact RCSB PDB requests for core metadata, Search API queries, and FASTA downloads. Use when a user wants concise RCSB summaries; save raw JSON or FASTA only on request.

Quality

93%

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

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 compact skill: dense with API-specific knowledge, fully executable examples for every capability, and a clean input/output contract with zero filler. It neither teaches known concepts nor buries anything that belongs in a separate file.

Dimension	Reasoning	Score
Conciseness	The body is lean and every token earns its place: exact base URLs, pager/max_items heuristics, and non-obvious operational notes like treating '...' in tool previews as UI truncation. It never explains concepts Claude already knows (no 'what is the PDB' padding), matching the 'lean and efficient' anchor.	5 / 5
Actionability	Fully executable, copy-paste-ready JSON request patterns for all three API surfaces (core entry lookup, full-text Search API POST with pager, FASTA download) plus a runnable bash one-liner. This matches the top anchor: specific examples covering the common cases.	5 / 5
Workflow Clarity	This is a simple, single-purpose, read-only request skill and the single action — pipe a JSON object to scripts/rest_request.py and interpret the documented output contract — is unambiguous, so the simple-skill exception applies. Input fields, output fields, success/failure shapes, and execution are each cleanly sectioned. No destructive or batch operations exist, so no validation checkpoint is required.	5 / 5
Progressive Disclosure	The skill is under 50 lines with no need for external references, and content is well organized into six clearly labeled sections. The only referenced path, scripts/rest_request.py, exists in the bundle, and the References section explicitly keeps the import package to two files — matching the simple-skill guideline for a top score.	5 / 5
	Total	20 / 20 Passed

Description

83%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, disciplined description: concrete third-person actions, an explicit 'Use when' clause, and a clear niche. Its only weaknesses are slightly narrow trigger coverage (no synonyms like 'protein structure' or '.pdb') and a when-clause that addresses summary use but not search or download use cases.

Suggestions

Broaden trigger terms to include synonyms users naturally say, e.g. 'protein structures', 'PDB IDs/entries', or '.pdb files', so the skill fires on phrasing beyond the literal 'RCSB summaries'.

Extend the 'Use when' clause to cover all three advertised capabilities, e.g. 'Use when a user wants concise RCSB/PDB summaries, needs to search the PDB, or wants FASTA sequence data'.

Dimension	Reasoning	Score
Specificity	The description names the domain and three concrete, comprehensive actions — 'core metadata, Search API queries, and FASTA downloads' — covering the skill's entire API surface, matching the top anchor for multiple specific concrete actions. Score 4 would apply only if coverage had gaps, which it does not.	5 / 5
Completeness	Both 'what' ('Submit compact RCSB PDB requests for core metadata, Search API queries, and FASTA downloads') and 'when' ('Use when a user wants concise RCSB summaries') are explicitly present. Not 5 because the when-clause covers only summary requests and omits triggers for searching or downloading structure data.	4 / 5
Trigger Term Quality	Includes good natural keywords users would say — 'RCSB', 'PDB', 'Search API', 'FASTA' — but misses common variations like 'protein structure', 'PDB ID/entry', or the '.pdb' extension. This sits between 'good keyword coverage; a few natural terms missing' (4) and comprehensive synonym coverage (5), closer to 4.	4 / 5
Distinctiveness Conflict Risk	'RCSB PDB' plus the specific API surfaces form a clear niche with distinct triggers; no realistic overlap with other skills, matching the 'clear niche with distinct triggers; minimal conflict risk' anchor.	5 / 5
	Total	18 / 20 Passed

Validation

100%

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: openai/plugins
Path: plugins/life-science-research/skills/rcsb-pdb-skill/SKILL.md
Commit: 5fd93af

Reviewed: 10 days 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.