CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

rdkit

Cheminformatics toolkit for fine-grained molecular control. SMILES/SDF parsing, descriptors (MW, LogP, TPSA), fingerprints, substructure search, 2D/3D generation, similarity, reactions. For standard workflows with simpler interface, use datamol (wrapper around RDKit). Use rdkit for advanced control, custom sanitization, specialized algorithms.

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

Quality

Content

63%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 delivers highly actionable, executable RDKit guidance with validating example workflows, but it behaves as a monolithic API reference rather than an overview. Much of the inline catalog duplicates the existing references/api_reference.md, hurting both conciseness and progressive disclosure.

Suggestions

Slim the 12 capability sections in SKILL.md to short overviews with one representative snippet each, and push the full API listings into the already-present references/api_reference.md to remove the duplication.

Fix the small executability gaps: define or parameterize bit_id in the DrawMorganBit example, replace the stray "continue" in the error-handling snippet with a proper guard, and standardize on the modern rdFingerprintGenerator API instead of mixing in deprecated AllChem.GetMorganFingerprintAsBitVect calls.

Add an explicit validate-fix-retry loop to at least one batch workflow (e.g., on parse failure, log the offending SMILES and continue, then report a summary of failed parses at the end) to model feedback-loop guidance.

DimensionReasoningScore

Conciseness

The prose is lean and code-focused with no concept padding, but the ~770-line body is a full inline API catalog across 12 capability sections that substantially duplicates references/api_reference.md, so it could be significantly tightened. This matches the 3 anchor (mostly efficient but includes content that should be trimmed or moved) rather than 4, where over-inlining would be only minor.

3 / 5

Actionability

Nearly all snippets are executable copy-paste RDKit calls using the modern rdFingerprintGenerator API, and three complete workflows are provided. Minor gaps keep it below 5: "Draw.DrawMorganBit(mol, bit_id, bit_info)" references an undefined bit_id, the error-handling example uses "continue" outside a loop, and deprecated AllChem.GetMorganFingerprintAsBitVect is mixed with the modern generator API.

4 / 5

Workflow Clarity

The Common Workflows section provides three clearly sequenced end-to-end workflows (drug-likeness, similarity screening, substructure filtering), each with inline None-validation checkpoints appropriate for batch operations, plus an error-handling best-practices section. It falls short of 5 because no explicit validate-fix-retry feedback loops are shown.

4 / 5

Progressive Disclosure

The references (api_reference.md, descriptors_reference.md, smarts_patterns.md) and scripts are real, one level deep, and clearly signaled with per-file descriptions in a Resources section. However, the extensive inline API catalog in sections 1-12 duplicates what the reference files already provide — content that should be separate is inline, matching the 3 anchor.

3 / 5

Total

14

/

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: it enumerates concrete capabilities in third person, provides an explicit use-when clause with concrete conditions, and proactively disambiguates from the datamol wrapper. The only weakness is modest trigger-term coverage — a few natural synonyms and file extensions users might say are absent.

DimensionReasoningScore

Specificity

The description lists many specific concrete actions — "SMILES/SDF parsing, descriptors (MW, LogP, TPSA), fingerprints, substructure search, 2D/3D generation, similarity, reactions" — with comprehensive coverage of the toolkit's capabilities and no padding. It is not a 4 because there are no meaningful gaps in the action inventory.

5 / 5

Completeness

The "what" is explicit and detailed, and the "when" is explicit with concrete conditions: "For standard workflows with simpler interface, use datamol (wrapper around RDKit). Use rdkit for advanced control, custom sanitization, specialized algorithms." Both questions are clearly and concretely answered, matching the 5 anchor.

5 / 5

Trigger Term Quality

Good keyword coverage including natural domain terms (SMILES, SDF, LogP, TPSA, fingerprints, substructure search, similarity, reactions), but a few natural user phrasings are missing (e.g., "molecules", "compounds", "drug discovery", ".smi", "Tanimoto"). It falls short of the 5 anchor's synonym and file-extension completeness.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear cheminformatics niche and explicitly disambiguates against the nearest competing skill (datamol) with usage boundaries, so it is unlikely to trigger for the wrong skill. This matches the 5 anchor's clear niche with distinct triggers.

5 / 5

Total

19

/

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 (790 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

Path

backend/cli/skills/chemistry/rdkit/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.