CtrlK
BlogDocsLog inGet started
Tessl Logo

diffdock

Diffusion-based molecular docking. Predict protein-ligand binding poses from PDB/SMILES, confidence scores, virtual screening, for structure-based drug design. Not for affinity prediction.

60

Quality

71%

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 ./backend/cli/skills/chemistry/diffdock/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

73%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 highly actionable, well-structured skill with excellent workflow sequencing and genuine validation checkpoints for batch operations. Its weaknesses are verbosity in the Resources/pointers sections, a factual slip in the temperature-parameter guidance, and inlining of content that the reference files were created to hold.

Suggestions

Fix the duplicated "temp_sampling_tor: 7.04" guidance (lines 353-354) — one of the two entries should name a different parameter or correct values, since both currently advise opposite adjustments to the same setting.

Move the full Modal wrapper, ensemble docking, and scoring-function integration details into references/workflows_examples.md, leaving SKILL.md a lean overview with pointers.

Cut the Resources section's per-file "Read this file when users need:" bullet lists down to one-line descriptions; the same guidance already appears inline where each file is first referenced.

DimensionReasoningScore

Conciseness

The body is mostly tool-specific and doesn't re-teach general chemistry or ML concepts, but it is noticeably padded: the Resources section re-describes every bundle file plus four-bullet "Read this file when users need:" lists that largely duplicate the earlier inline pointers, the pose-vs-affinity distinction is stated three times (Overview, Confidence Interpretation, Limitations), and the 570-line body inlines material (full Modal wrapper, parameter tuning) that its own progressive-disclosure structure says belongs in references. This fits the 'mostly efficient but could be tightened' 3 anchor.

3 / 5

Actionability

Guidance is largely copy-paste ready: complete bash commands for single, batch, and screening runs; a full executable Modal Python wrapper; script invocations with concrete flags (--top 5, --threshold 0.0, --export); and a concrete CSV format with required columns. It falls short of 5 because the Parameter Customization section lists "temp_sampling_tor: 7.04" twice with conflicting advice (increase for flexible, decrease for rigid), which would mislead an agent, and the Modal wrapper is inline code the user must assemble rather than a bundled script.

4 / 5

Workflow Clarity

Workflows 1-3 are clearly sequenced (single docking, batch docking, result analysis), and the batch workflow includes explicit validation before launch ("python scripts/setup_check.py", "python scripts/prepare_batch_csv.py ... --validate"), so the batch-operations cap does not apply. The Troubleshooting section adds issue/cause/solution feedback loops covering OOM, low confidence, and environment errors, matching the 5 anchor of clear sequence, explicit validation, and error-recovery guidance.

5 / 5

Progressive Disclosure

All referenced bundle files exist (references/confidence_and_limitations.md, references/parameters_reference.md, references/workflows_examples.md, three scripts, two assets), references are one level deep, and they are explicitly signaled ("Read `references/parameters_reference.md` using the Read tool"). It stops short of 5 because the 570-line body inlines substantial content that belongs in those references (the complete Modal wrapper code, parameter customization details, advanced ensemble/scoring integration), making SKILL.md more than an overview.

4 / 5

Total

16

/

20

Passed

Description

70%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 capabilities, explicit input formats, and a clear negative boundary. Its main weakness is the missing explicit 'Use when...' trigger clause, which caps completeness, and slightly compressed action phrasing.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to dock a ligand, predict a binding pose, or run virtual screening on a compound library."

State the clipped capabilities as full actions, e.g. "Scores prediction confidence" and "Runs batch virtual screening", and mention protein-sequence (ESMFold) input which the skill supports.

Include a few natural synonym phrases users say, such as "binding pose" and "where does this molecule bind".

DimensionReasoningScore

Specificity

"Predict protein-ligand binding poses from PDB/SMILES, confidence scores, virtual screening" lists several concrete capabilities with concrete input formats (PDB, SMILES). It falls short of the 5 anchor because "confidence scores" and "virtual screening" are clipped noun phrases rather than fully stated actions, and coverage has minor gaps (e.g., batch processing, protein-sequence input via ESMFold).

4 / 5

Completeness

The "what" is clearly stated (diffusion-based docking, pose prediction, confidence, screening), and the boundary "Not for affinity prediction" is a useful negative scope. However, "for structure-based drug design" is a domain hint rather than an explicit 'Use when...' trigger clause, so per the judging guideline this is capped at 3.

3 / 5

Trigger Term Quality

Natural terms a docking user would say are present: "molecular docking", "protein-ligand binding poses", "PDB/SMILES", "virtual screening", "structure-based drug design". A few natural phrasings are missing ("dock this ligand", "binding site", "screen a compound library"), matching the 4 anchor of good coverage with a few natural terms absent rather than the comprehensive 5 anchor.

4 / 5

Distinctiveness Conflict Risk

"Diffusion-based molecular docking" plus "Predict protein-ligand binding poses" carves out a clear niche with distinct triggers, and "Not for affinity prediction" explicitly fences off the nearest confusion risk. It would not trigger for generic chemistry, MD simulation, or affinity-scoring skills.

5 / 5

Total

16

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (591 lines); consider splitting into references/ and linking

Warning

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository
synthetic-sciences/openscience
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.