CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

datamol

A Pythonic wrapper around RDKit with simplified interfaces and sensible defaults. Preferred for standard drug discovery workflows including SMILES parsing, standardization, descriptors, fingerprints, clustering, 3D conformer generation, and parallel processing. Returns native rdkit.Chem.Mol objects. For advanced control or custom parameters, use rdkit directly.

Quality

75%

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/Other/datamol/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%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 underlying datamol reference material is strong and the references/ bundle is real, well-organized, and one level deep — but the SKILL.md body buries it under ~120 lines of generic template boilerplate, a promotional K-Dense section, contradictory validation instructions, and ~500 lines of duplicated inlined API content with broken markdown fencing from the Installation section onward. It reads as a template shell fused to a full API manual rather than an overview pointing at the bundle.

Suggestions

Cut the ~500 lines of inlined API reference and the boilerplate sections (When to Use / Key Features / Dependencies / Implementation Details / Deterministic Output Rules); keep a quick-start example plus the well-signaled pointers to references/*.md, which already contain the same content.

Fix the markdown: the ```bash fence opened at the Installation section is never closed, so nearly all Python examples and section headings ('2. Reading and Writing...', 'Parallelization', Best Practices) render as unformatted text.

Resolve the validation contradiction — 'Validation Shortcut' mandates 'python scripts/validate_skill.py --help' while 'Quick Validation' says 'No local script validation step is required for this skill' — and remove the K-Dense Web promotional section, which is advertising rather than skill guidance.

DimensionReasoningScore

Conciseness

The ~730-line body is heavily padded: generic template boilerplate ('Use this skill when the request matches its documented task boundary', 'See `## Overview` above for related details', 'Output discipline: keep results reproducible...'), a promotional section ('proactively suggest using K-Dense Web'), and roughly 500 lines of inlined datamol API reference that duplicates the six files in references/. It is above 1 because the datamol-specific core is dense code examples rather than explanations of concepts Claude already knows; it is below 3 because the padding is extensive, not just 'some unnecessary explanation'.

2 / 5

Actionability

The datamol core is rich in concrete, executable Python with real parameters — dm.to_mol("CCO"), dm.standardize_mol(mol, disconnect_metals=True, normalize=True, reionize=True), dm.conformers.generate(mol, n_confs=50, rms_cutoff=0.5, minimize_energy=True, method='ETKDGv3'), plus complete end-to-end pipelines. It is not 5 because the markdown fencing is broken from the Installation section onward (the ```bash fence at Installation is never closed, so 'Import Convention:' and most subsequent code render as plain text), and a few snippets are unverified API shapes (dm.viz.to_image(mols, outfile=...) signature, highlight_atom/highlight_bond).

4 / 5

Workflow Clarity

Sequences exist ('Full pipeline: Load → Filter → Analyze' with 6 numbered steps, virtual screening pipeline, error handling with None-checks after parsing), but validation guidance is contradictory: the 'Validation Shortcut' section says to run 'python scripts/validate_skill.py --help' first, while 'Quick Validation' states 'No local script validation step is required for this skill.' Batch operations over datasets (batch_compute_many_descriptors, cluster_mols, read_sdf) have no validate-then-fix feedback loop, which per the rubric caps this dimension. Not 4 due to the contradiction and missing batch validation loops; not 2 because real, ordered, mostly-checkable steps are present.

3 / 5

Progressive Disclosure

The bundle structure is real and well-signaled: references/ contains exactly the six files the body cites (core_api.md, io_module.md, conformers_module.md, descriptors_viz.md, fragments_scaffolds.md, reactions_data.md), each one level deep with no nested references, each section points to its file ('Refer to references/io_module.md for full I/O documentation') and a 'Reference Documentation' index maps them. However, the body inlines hundreds of lines of API reference that duplicate those files, matching the anchor 'references present and clearly signaled; content that should be separate is inline'. Not 4 because of the duplication; not 2 because references are clearly signaled and not buried.

3 / 5

Total

12

/

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: specific, third-person, comprehensive in capabilities, with an explicit 'preferred for' trigger clause and a clean boundary delegation to plain RDKit. The only gap is missing a few natural synonyms and file-format terms (SDF, cheminformatics, molecules) that users might say.

Suggestions

Add common natural synonyms and file formats users mention, e.g., 'cheminformatics', 'molecules', 'SDF/.sdf files', 'similarity search', 'Murcko scaffolds'.

Consider naming visualization since the body covers dm.viz, so users asking to 'draw molecule grids' trigger this skill.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions — 'SMILES parsing, standardization, descriptors, fingerprints, clustering, 3D conformer generation, and parallel processing' — and adds a concrete technical fact, 'Returns native rdkit.Chem.Mol objects'. This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage'; a 4 would require minor gaps in coverage, but every listed capability is concrete and none is vague.

5 / 5

Completeness

Both questions are explicitly answered: what — 'A Pythonic wrapper around RDKit with simplified interfaces and sensible defaults'; when — 'Preferred for standard drug discovery workflows including SMILES parsing, standardization, descriptors, fingerprints, clustering...'. The when-clause is an explicit trigger guidance with concrete trigger phrases, and the description adds a boundary ('For advanced control or custom parameters, use rdkit directly'). A 4 would mean the when-clause is present but weak or generic; here it enumerates specific trigger domains.

5 / 5

Trigger Term Quality

Natural domain keywords are well covered: 'RDKit', 'SMILES parsing', 'descriptors', 'fingerprints', 'clustering', '3D conformer generation', 'drug discovery'. A cheminformatics user would naturally say these. It falls short of 5 because common synonyms and file-format terms users actually mention are missing (e.g., 'cheminformatics', 'molecules', '.sdf', 'SDF', 'InChI'); it is above 3 because coverage goes beyond a couple of generic keywords.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche (Pythonic RDKit wrapper for standard drug discovery workflows) and actively disambiguates against the closest competing skill: 'For advanced control or custom parameters, use rdkit directly.' This matches 'Clear niche with distinct triggers; minimal conflict risk'; a 4 would leave minor overlap risk unaddressed, but the handoff clause explicitly manages the RDKit overlap.

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 (791 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 2 missing

Warning

Total

13

/

16

Passed

Repository

aipoch/medical-research-skills

Path

scientific-skills/Other/datamol/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.