CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

esm

Toolkit for protein language models (ESM3 for multimodal generative protein design; ESM C for efficient embeddings). Use when you need sequence/structure/function generation or prediction, inverse folding, protein embeddings, or scalable inference via local weights or the Forge API.

Quality

80%

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

Fix and improve this skill with Tessl

tessl review fix ./scientific-skills/Protocol Design/esm/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

Well-structured skill with executable examples and exemplary progressive disclosure: the body stays lean while four real reference files carry the detail. Weaknesses are redundancy between 'When to Use' and 'Key Features', prose-only coverage of structure prediction/inverse folding, and no validation or error-handling in the batch Forge workflow.

Suggestions

Merge the 'Key Features' section into 'When to Use' (they cover the same six capabilities) and drop explanations of known concepts like the temperature definition; keep the model-ID and track details.

Add validation and error handling to the Forge batch workflow — e.g., asyncio.gather(..., return_exceptions=True), per-task failure inspection, and retry guidance — since batch operations without a feedback loop currently cap workflow clarity at 3.

Include a short runnable snippet for structure prediction and inverse folding (track='structure' export and ESMProtein.from_pdb(...) followed by sequence generation), or point to a specific section of references/esm3-api.md containing that code, so all headline features have executable coverage.

DimensionReasoningScore

Conciseness

The 'Key Features' section largely restates the 'When to Use' bullets (multimodal generation, structure prediction/inverse folding, ESM C embeddings, Forge batch all appear twice), and lines like 'temperature: controls sampling diversity (lower = more deterministic; higher = more diverse)' explain concepts Claude already knows. Mostly efficient but needs tightening, matching the 3 anchor; not 4 because the duplication is a whole padded section rather than minor over-explanation.

3 / 5

Actionability

Three complete, executable code scenarios (local ESM3 completion, Forge async batch, ESM C embeddings) with real model IDs, plus copy-paste installation commands ('uv pip install esm', 'uv pip install flash-attn --no-build-isolation'). Falls short of 5 because headline features — structure prediction and inverse folding — get only prose recipes ('ESMProtein.from_pdb(...)... then generate on the sequence track') with no runnable example.

4 / 5

Workflow Clarity

The Forge batch workflow (asyncio.gather over five proteins) involves batch operations but has no validation or error handling — no return_exceptions, retry guidance, or output verification — and the rubric explicitly caps workflow clarity at 3 for batch operations without validation. The three example scenarios are also independent demonstrations rather than a sequenced process, so this is not the 4 anchor's 'clear sequence with most checkpoints'.

3 / 5

Progressive Disclosure

The body is a lean overview that signals each topic-mapped reference at the exact point of need ('see references/esm3-api.md' for structure/PDB export, 'see references/esm-c-api.md' for batching strategies, 'detailed in references/forge-api.md' for auth/rate limits), and all four referenced files exist as substantial one-level-deep documents (450-680 lines each, no further nesting). This matches the 5 anchor: clear overview, well-signaled one-level-deep references, easy navigation.

5 / 5

Total

15

/

20

Passed

Description

87%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, an explicit 'Use when' trigger clause, and a clearly distinct niche. The only deductions are the second-person 'Use when you need' phrasing and a few missing natural synonym terms.

DimensionReasoningScore

Specificity

Lists multiple concrete actions ('sequence/structure/function generation or prediction, inverse folding, protein embeddings, or scalable inference via local weights or the Forge API') with comprehensive coverage of the skill's scope. This would rate 5, but the second-person phrasing 'Use when you need' violates the third-person voice guideline, reducing the score by 1.

4 / 5

Completeness

Explicitly answers both what ('ESM3 for multimodal generative protein design; ESM C for efficient embeddings') and when ('Use when you need sequence/structure/function generation or prediction, inverse folding, protein embeddings, or scalable inference') with concrete trigger phrases, matching the 5 anchor. Not the 4 anchor because the 'when' clause is fully explicit rather than merely present.

5 / 5

Trigger Term Quality

Good natural keywords users would say: 'protein design', 'inverse folding', 'protein embeddings', 'prediction', 'Forge API'. A few natural terms are missing — e.g., 'protein engineering', 'structure prediction' as a standalone phrase, or 'sequence design' — so it falls just short of the comprehensive synonym coverage of the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

Clear niche — ESM protein language models and the Forge API — with distinct triggers ('inverse folding', 'ESM C', 'Forge'); minimal risk of firing for the wrong skill. It names specific models and APIs rather than generic capability language, so it is not the 4 anchor's 'minor overlap risk'.

5 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

aipoch/medical-research-skills

Path

scientific-skills/Protocol Design/esm/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.