CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pubchem-database-skill

Programmatic access to the PubChem database (via PUG-REST API and PubChemPy) for searching chemical compounds, retrieving physicochemical properties, performing structure similarity/substructure searches, and obtaining bioactivity data.

Quality

81%

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

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 fully executable, well-organized guidance for a simple single-purpose skill, with a real reference file and clean progressive disclosure. Its main weakness is redundancy — capability lists repeated across three sections and each example duplicated in bash and Python forms.

Suggestions

Collapse "When to Use", "Key Features", and the overlapping parts of "Implementation Details" into a single capability summary to remove the repeated lists.

Show each example in one form only (Python import style), dropping the redundant `python -c` bash variants.

Promote the api_reference.md pointer to a clearly signaled section (e.g., "## References") instead of a nested bullet under Implementation Details.

DimensionReasoningScore

Conciseness

"When to Use", "Key Features", and "Implementation Details" largely repeat the same capability list three times, and each example is shown twice (bash `python -c` plus Python form), so the body could be meaningfully tightened. It is not 4 because the duplication goes beyond minor over-explanation; not 2 because nothing explains concepts Claude already knows and all content is accurate and skill-specific.

3 / 5

Actionability

The install command plus fully executable, copy-paste-ready examples cover all three supported operations (get_properties, structure_search, get_bioactivity), matching the real script's signatures in scripts/pubchem_ops.py. It is not 4 because there are no gaps: common cases are covered with runnable code in both CLI and Python forms.

5 / 5

Workflow Clarity

This is a simple, single-purpose API skill where each operation is an unambiguous single call, so the simple-skill exception applies: dependencies → examples → input constraints is clear, with error handling and troubleshooting guidance ("Verify query format (e.g., valid SMILES or InChI) if results are empty") serving as feedback. Not 4 because no checkpoints are missing — there are no destructive or batch operations requiring validation.

5 / 5

Progressive Disclosure

The bundle is well structured: the script (scripts/pubchem_ops.py) and a real one-level-deep reference (references/api_reference.md) exist and are appropriately split from the overview. It is not 5 because the reference pointer is buried as "Additional reference: API documentation pointers: references/api_reference.md" in a nested bullet at the bottom rather than a clearly signaled dedicated section; not 3 because structure and file placement are otherwise good.

4 / 5

Total

17

/

20

Passed

Description

75%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, specific description that clearly states what the skill does with concrete, domain-anchored actions and excellent distinctiveness. Its main weakness is the missing "when to use" trigger clause, which caps completeness and slightly limits natural triggering.

Suggestions

Add an explicit trigger clause, e.g., "Use when the user mentions PubChem, chemical compounds, SMILES/CID/InChI lookups, molecular properties, or compound bioactivity."

Include the natural query terms users actually say — SMILES, molecular formula, CID, molecule, drug/compound properties — to broaden trigger coverage.

State the when-conditions in the same imperative style as the good examples so both "what" and "when" are explicit and concrete.

DimensionReasoningScore

Specificity

The description lists four concrete actions — "searching chemical compounds", "retrieving physicochemical properties", "performing structure similarity/substructure searches", and "obtaining bioactivity data" — which comprehensively cover the skill's operations and name the specific mechanisms (PUG-REST API, PubChemPy). It is not 4 because there are no coverage gaps relative to the actual functionality.

5 / 5

Completeness

The "what" is explicit and clear, but there is no "Use when..." clause or equivalent explicit trigger guidance, capping completeness at 3 per the judging guidelines. It is not 4 because the "when" is entirely absent rather than merely implicit or weak.

3 / 5

Trigger Term Quality

Good natural keywords are present ("PubChem", "chemical compounds", "physicochemical properties", "similarity", "bioactivity data"), but common variations users would say are missing (e.g., SMILES, molecular formula, CID, molecule, drug discovery). It is not 5 because synonym and variation coverage is incomplete; not 3 because the terms present are the ones a PubChem-focused user would most naturally use.

4 / 5

Distinctiveness Conflict Risk

"Programmatic access to the PubChem database (via PUG-REST API and PubChemPy)" carves out a clear niche with distinct triggers and minimal conflict risk with other skills. It is not 4 because no closely related skill would plausibly collide on these triggers.

5 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

aipoch/medical-research-skills

Path

scientific-skills/Evidence Insight/pubchem-database-skill/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.