CtrlK
BlogDocsLog inGet started
Tessl Logo

adme-property-predictor

Analyze data with `adme-property-predictor` using a reproducible workflow, explicit validation, and structured outputs for review-ready interpretation.

35

Quality

44%

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/Data Analysis/adme-property-predictor/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

38%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 contains genuinely useful domain content (ADME property tables, best practices, pitfalls, troubleshooting) plus a real, verified CLI, but it is buried in a bloated, repetitive document with corrupted text, non-executable code examples, and extensive dead references to scripts and reference files that are not shipped. It needs consolidation and alignment between documentation and the actual bundle.

Suggestions

Consolidate the ~8 overlapping governance sections (Workflow, Output Requirements, Output Contract, Response Template, Inputs to Collect, Validation and Safety Rules, Error Handling, Input Validation) into one workflow section, and fix the corrupted 'When to Use' bullet that ends mid-sentence at 'unsupported as.'.

Align the documented bundle with reality: either ship the six listed reference files and eight listed scripts or remove those listings, and reference the one file that does exist (references/runtime_checklist.md).

Remove or fix non-executable code: the 'target_profile={"hia": >80, "bbb": <0.3, ...}' snippet is invalid Python, and the --filter/--rank-by/--top-n flags in the 'Complete Workflow Example' are not implemented by scripts/main.py.

DimensionReasoningScore

Conciseness

The ~715-line body repeats the same governance guidance across many overlapping sections ('Workflow', 'Output Requirements', 'Response Template', 'Output Contract', 'Inputs to Collect', 'Validation and Safety Rules'), and the first 'When to Use' bullet is corrupted mid-sentence ('...stop early if the task would require unsupported as.'). Verbose even though the domain material itself is accurate.

2 / 5

Actionability

Some guidance is verified-executable ('python -m py_compile scripts/main.py', and the documented parameters --smiles/--properties/--format/--input/--output match scripts/main.py's argparse), but other examples reference surfaces that do not exist: 'from scripts.adme_predictor import ADMEPredictor' (file absent), the invalid snippet 'target_profile={"hia": >80, "bbb": <0.3, ...}', and CLI flags --filter/--rank-by/--top-n that main.py does not implement.

3 / 5

Workflow Clarity

A numbered Workflow with validation checkpoints, a smoke check, Input Validation, and Error Handling fallbacks is present, but the sequence is scattered across eight redundant sections that partially restate each other, and one instruction line is garbled, making the actual execution path hard to follow. Not score 4 because the duplication and corruption undermine sequence clarity despite present checkpoints; not score 2 because explicit validation and fallback paths do exist.

3 / 5

Progressive Disclosure

A 700-line monolithic body inlines troubleshooting, property tables, and pitfalls that belong in reference files, while the 'References' section lists six files (lipinski_rules.md, qsar_models.md, adme_databases.md, property_ranges.md, model_validation.md, cheminformatics_basics.md) and 'Scripts' lists nine — none of which exist in the bundle (only references/runtime_checklist.md and scripts/main.py are present, and runtime_checklist.md is never referenced in the body). Dead pointers make navigation unreliable.

2 / 5

Total

10

/

20

Passed

Description

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

The description is generic boilerplate that fails to convey the skill's actual purpose: predicting ADME properties and drug-likeness for small molecules. It names no concrete capability, no natural trigger terms, and no use-when guidance, so it would neither be selected correctly nor distinguished from other data-analysis skills.

Suggestions

Rewrite to state concrete capabilities: 'Predict ADME properties (absorption, distribution, metabolism, excretion) and drug-likeness scores (Lipinski, Veber, QED) for small molecules from SMILES strings or compound libraries.'

Add an explicit trigger clause with natural user terms: 'Use when the user provides SMILES or a compound library and wants ADME, pharmacokinetic, permeability, solubility, or drug-likeness predictions.'

Drop filler phrases ('reproducible workflow', 'review-ready interpretation') that add no distinguishing information and inflate length.

DimensionReasoningScore

Specificity

'Analyze data with `adme-property-predictor` using a reproducible workflow, explicit validation, and structured outputs' offers only generic process language ('analyze', 'validate', 'interpret') without a single concrete capability — the actual domain (ADME/drug-likeness prediction for small molecules) is never named. Not score 3 because there is no concrete action at all, let alone 1-2 specific ones; not score 1 because it at least names a tool and a bounded process.

2 / 5

Completeness

The 'what' is vague ('Analyze data...') and there is no 'when to use' clause or equivalent trigger guidance anywhere in the description — below the rubric cap of 3 for a missing 'Use when...' clause. Not score 1 because it does state a bounded what (data analysis with reproducible workflow and structured outputs), albeit generically.

2 / 5

Trigger Term Quality

No natural keywords a user would say when needing this skill: 'ADME', 'pharmacokinetic', 'drug-likeness', 'SMILES', 'solubility' are all absent, leaving only generic words like 'data', 'workflow', 'validation', and the technical tool name. Not score 1 because a few generic keywords ('data', 'interpretation') are present; not score 3 because there is no relevant domain keyword coverage whatsoever.

2 / 5

Distinctiveness Conflict Risk

'Analyze data' is so broad it would compete with virtually every data-analysis skill; the tool name in backticks is not a phrase users naturally invoke. Not score 1 because the tool name and 'structured outputs for review-ready interpretation' give a slight distinguishing hook; not score 3 because the trigger surface is entirely generic with high overlap risk across the whole data-analysis category.

2 / 5

Total

8

/

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

skill_md_line_count

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

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository
aipoch/medical-research-skills
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.