CtrlK
BlogDocsLog inGet started
Tessl Logo

tooluniverse-protein-structure-retrieval

Protein structure retrieval from RCSB PDB, PDBe, and AlphaFold with disambiguation, quality assessment (resolution, R-factor, pLDDT), and metadata. Distinguishes high-quality experimental (X-ray under 2 Angstrom) vs predicted vs medium-quality structures. Use for fetching protein structures, structure-quality comparison, and selecting structures for drug design or modeling.

71

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-structured, domain-savvy skill body: executable tool calls, explicit phased workflow with checklists, fallback chains, and error-recovery guidance. The main improvement opportunities are removing the small redundancy between the Domain Reasoning prose and the Quality Assessment tables, and moving the Tool Reference and quality-tier details into a reference file.

Suggestions

Merge the 'Domain Reasoning' prose into the Quality Assessment section — the X-ray <2 Å guidance is stated twice — to tighten conciseness without losing the domain thresholds.

Replace the comment-only Phase 1 pseudocode ('# By PDB ID: direct retrieval') with actual runnable calls and bind the placeholder variables (name, uniprot_id) to concrete examples, matching the fully-executable Phase 2 block.

Move the Tool Reference catalog and the quality-tier/resolution-use-case tables into a single references file (e.g. references/quality-tiers.md) with a one-level-deep pointer from SKILL.md, keeping the main file a lean overview.

DimensionReasoningScore

Conciseness

The body is lean — tables, short code blocks, and terse directives like 'Retrieve silently. Do NOT narrate the process.' — and the domain thresholds it teaches (X-ray <2 Å for drug design, pLDDT bands) are specifics Claude cannot reliably be assumed to know, so they earn their tokens. It misses 5 because the 'Domain Reasoning' prose partially restates the Quality Assessment tier table and Resolution Use Cases lines, a small redundancy that could be trimmed.

4 / 5

Actionability

Concrete, named tool calls appear throughout (tu.tools.PDBeValidation_get_quality_scores(pdb_id=pdb_id), fallback chains as a table, error responses per error string), giving mostly executable guidance. It is not 5 because Phase 1 mixes runnable calls with comment-only pseudocode ('# By PDB ID: direct retrieval') and undefined variables (name, uniprot_id) that leave minor gaps for copy-paste use.

4 / 5

Workflow Clarity

A clearly sequenced four-phase workflow (Clarify → Disambiguate → Retrieve → Report) with explicit checkpoints: criteria for when to ask vs skip, an Identity Checklist, fallback chains for tool failures, and an error-handling table with retry guidance ('Retry once, provide alternative link'). This matches the top anchor's feedback loops, error recovery, and checklists; score 4 would understate the presence of these explicit validation and recovery structures.

5 / 5

Progressive Disclosure

The body is well-sectioned (Workflow, phases, Quality Assessment, Error Handling, Tool Reference) with no nested or buried references and no bundle files to navigate. It does not reach 5 because at ~130 lines with no external files, the Tool Reference and quality-tier tables are candidates for a one-level-deep reference file that would keep SKILL.md a pure overview.

4 / 5

Total

17

/

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 description: concrete capabilities, explicit trigger guidance, and a well-defined niche in protein structure retrieval with quality assessment. The only weakness is modest keyword coverage — synonyms like '3D structure', 'protein model', or '.pdb' would broaden natural-language triggering.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'retrieval from RCSB PDB, PDBe, and AlphaFold with disambiguation, quality assessment (resolution, R-factor, pLDDT), and metadata' plus 'distinguishes high-quality experimental (X-ray under 2 Angstrom) vs predicted vs medium-quality structures' — giving comprehensive, specific coverage rather than generic claims. It does not fall to 4 because coverage of the skill's operations (fetch, compare quality, select) is essentially complete, not merely 'several actions with minor gaps'.

5 / 5

Completeness

It explicitly answers 'what' (retrieval with disambiguation, quality assessment, metadata, distinguishing structure tiers) and 'when' with a concrete trigger clause: 'Use for fetching protein structures, structure-quality comparison, and selecting structures for drug design or modeling.' Both halves are explicit and concrete, matching the top anchor; score 4 would require the 'when' to be less explicit than it is.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'fetching protein structures', 'structure-quality comparison', 'selecting structures for drug design or modeling', plus database names (RCSB PDB, PDBe, AlphaFold) users would mention. It falls short of 5 because common variations like '3D structure', 'protein model', 'download PDB file', or '.pdb' extension are missing; it is above 3 because the phrases present are ones users would naturally say.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — protein structure retrieval from named structural-biology databases with quality-tier assessment — with trigger phrases (PDB, AlphaFold, resolution, pLDDT, drug design) that are unlikely to fire for unrelated skills. Not 4, since even overlap with a general 'drug design' skill is defused by the structure-retrieval framing.

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
mims-harvard/ToolUniverse
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.