CtrlK
BlogDocsLog inGet started
Tessl Logo

binding-affinity

Empirical affinity estimates, ligand energy inspection, docking-score consensus, and batch virtual screening. Full MM/GBSA requires a validated external workflow.

60

Quality

70%

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/binding-affinity/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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-sequenced body with executable commands and honest validation framing, held back by repeated MM/GBSA disclaimer padding and a bundled reference file (references/scoring_methods.md) that is never surfaced from the main skill.

Suggestions

Link references/scoring_methods.md explicitly (e.g. 'See [scoring_methods.md](references/scoring_methods.md) for method theory, feature definitions, and accuracy expectations') and move the Output Interpretation detail tables into it.

Consolidate the five separate MM/GBSA/ligand-heuristic disclaimers into the single 'MM/GBSA capability boundary' section and reference it once elsewhere.

Add an explicit post-run validation step to Workflow 4 (e.g. verify exit status and check screening_hits.csv row count against the library before reporting hits).

DimensionReasoningScore

Conciseness

The body is mostly efficient — command blocks, tables, and JSON examples all earn their tokens — but the MM/GBSA boundary disclaimer is repeated at least five times (Key capabilities, Validation Warning, 'MM/GBSA capability boundary', Workflow 2, 'Ligand Heuristic Scores', Troubleshooting), which is unnecessary padding. It is not 2 because no section explains concepts Claude already knows, and not 4 because the repetition is substantial rather than a minor trim.

3 / 5

Actionability

Every workflow is a complete, copy-paste-ready command with all flags shown (e.g. 'python scripts/predict.py --protein prepared_protein.pdb --poses docking_results/poses.sdf --output affinity.json'), plus install commands, quick verification snippets, a full 6-step pipeline, and concrete example outputs. Fully executable with the common cases covered.

5 / 5

Workflow Clarity

Workflows are clearly sequenced (Workflow 5 numbers steps 1-6) with a general verification convention — 'Verify the exit status and record status before using a score', the _script_manifest.jsonl check, failed-record handling, and a Troubleshooting section. It is not 5 because the batch screening workflow (Workflow 4) has no embedded validate-after-run checkpoint or fix-and-retry loop; it is not 3 because exit-status/manifest verification and troubleshooting do provide real checkpoints for the batch path.

4 / 5

Progressive Disclosure

Section structure is good (Overview → When to Use → Installation → Workflows → Script Reference → Output Format → Interpretation → Troubleshooting), but the bundled references/scoring_methods.md is never linked or mentioned anywhere in the body — a buried reference — and detailed content that belongs there (output interpretation tables, scoring-method detail) is inlined. It is not 2 because the body is well-sectioned rather than monolithic, and not 4 because an entire bundled reference file is undiscoverable from the entry point.

3 / 5

Total

15

/

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 concise, specific description with strong domain keyword coverage and a well-drawn capability boundary, weakened only by the complete absence of a 'Use when...' trigger clause, which caps completeness per the rubric.

Suggestions

Append a trigger clause such as 'Use when the user asks to predict binding affinity, estimate Kd/pKd, rank docked poses by affinity, rescore with MM/GBSA, or virtually screen a compound library.'

Mention the concrete output units (pKd, Kd in nM, ΔG kcal/mol) so the 'what' is answered in the same operational terms users think in.

Include the common natural phrases 'binding affinity' and 'Kd' verbatim to strengthen trigger matching.

DimensionReasoningScore

Specificity

The description lists several concrete, domain-specific actions — 'Empirical affinity estimates, ligand energy inspection, docking-score consensus, and batch virtual screening' — plus an explicit MM/GBSA boundary. It falls just below anchor 5 because the actions are terse noun phrases and omit key outputs (pKd/Kd/ΔG, pose ranking) that would make coverage comprehensive.

4 / 5

Completeness

The 'what' is clear (four named capabilities plus a boundary statement), but there is no 'Use when...' clause or equivalent explicit trigger guidance; the when is only weakly implied by the domain terms. Per the rubric guideline, a missing 'Use when' clause caps completeness at 3 — it is not 4 because the when is absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Good natural keyword coverage: 'affinity', 'docking-score', 'consensus', 'virtual screening', 'MM/GBSA' are all phrases users would plausibly say. A few natural terms are missing — the literal phrases 'binding affinity', 'predict', 'Kd', 'pKd' never appear, so it sits at anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche — post-docking affinity estimation — and explicitly disclaims full MM/GBSA ('Full MM/GBSA requires a validated external workflow'), minimizing conflict with molecular-docking, pocket-detection, or MD skills. It is not 4 because the only overlap ('docking-score') is immediately qualified as consensus scoring of docking results, not pose generation.

5 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

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.