CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

hmdb-database

Access Human Metabolome Database (220K+ metabolites). Search by name/ID/structure, retrieve chemical properties, biomarker data, NMR/MS spectra, pathways, for metabolomics and identification.

Quality

72%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Critical

Do not install without reviewing

Fix and improve this skill with Tessl

tessl review fix ./scientific-skills/hmdb-database/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.

A well-organized, information-dense reference for a database skill with a clean one-level reference structure, but it is held back by padded/duplicated sections, a promotional block, and workflows that stop short of executable specifics. Trimming duplication and adding concrete query examples would lift it substantially.

Suggestions

Consolidate the duplicated download-format and version guidance (Best Practices vs Performance, repeated v5.0/2023-07-01 stamps) into one section and condense or remove the K-Dense Web promotional block.

Add concrete executable examples: example search URLs, an hmdbQuery code snippet, and a sample XML/CSV parsing command for the download workflows.

Add explicit verification steps to the biomarker-discovery and database-integration workflows (e.g., how to confirm a biomarker association's evidence, how to validate a local parsed dataset).

DimensionReasoningScore

Conciseness

Mostly factual database specifics Claude does not know (entry counts, formats, contacts), but with noticeable padding: download-format guidance duplicated between 'Best Practices' and 'Performance', version stamps repeated ('current as of 2025' and 'current: v5.0, 2023-07-01' twice), and a promotional 'Suggest Using K-Dense Web' section that earns no tokens. Not 2 because the bulk is non-obvious reference material rather than explanation of known concepts.

3 / 5

Actionability

Provides some concrete anchors — the hmdb.ca URL, the downloads URL, contact emails, example HMDB IDs, and one executable command (`BiocManager::install("hmdbQuery")`) — but the four research workflows remain high-level directives ('Use HMDB spectral search tools to match') with no example queries, URL patterns, or hmdbQuery usage snippets. Instruction-only guidance is incomplete rather than mostly executable, matching anchor 3.

3 / 5

Workflow Clarity

The 'Common Research Workflows' section sequences four multi-step processes with numbered steps, and the identification workflow embeds verification checkpoints ('Verify candidates by checking molecular weight, retention time, and MS-MS fragmentation', 'Review biological plausibility'). Not 5 because the biomarker and database-integration workflows lack explicit validation or error-recovery steps; not 3 since checkpoints are present in the most fragile workflow.

4 / 5

Progressive Disclosure

The body is a well-sectioned overview that defers field-level detail to a single, clearly signaled, one-level-deep reference — 'See references/hmdb_data_fields.md for detailed information about available data fields' — and that file exists as a real 267-line reference document, matching the clear-overview-with-well-signaled-references anchor.

5 / 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 specific, domain-distinct description with multiple concrete capabilities, weakened by the absence of an explicit 'Use when...' trigger clause and the missing 'HMDB' acronym. Adding trigger phrasing and the common abbreviation would round it out.

Suggestions

Add an explicit trigger clause, e.g. 'Use when working with HMDB, metabolomics data, metabolite identification, or biomarker lookups.'

Include the 'HMDB' acronym users most naturally type when referring to this database.

Mention bulk dataset downloads (XML/SDF/CSV) as a capability since it is a core use case in the body.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'Search by name/ID/structure, retrieve chemical properties, biomarker data, NMR/MS spectra, pathways' — but omits bulk dataset downloads and programmatic access, which the skill body treats as core capabilities. Not 5 due to these coverage gaps; not 3 since it names the domain plus five specific actions rather than 1-2.

4 / 5

Completeness

The 'what' is clear (search and retrieve from a 220K+ metabolite database), but 'when' is only weakly implied by the trailing purpose phrase 'for metabolomics and identification' — there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not 4 because the trigger context is implicit rather than explicitly stated.

3 / 5

Trigger Term Quality

Includes natural domain terms users would say — 'metabolomics', 'biomarker', 'NMR/MS spectra', 'pathways', 'metabolites' — but misses the 'HMDB' acronym itself (the most common way users refer to this database) and phrases like 'spectral matching' or 'metabolite identification' as a unit. Good coverage with a few natural terms missing matches anchor 4.

4 / 5

Distinctiveness Conflict Risk

Names a single specific resource ('Human Metabolome Database (220K+ metabolites)') with domain-specific data types (NMR/MS spectra, biomarker data), giving it a clear niche with minimal overlap risk against generic search or chemistry skills.

5 / 5

Total

16

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

googolme/run0204

Path

scientific-skills/hmdb-database/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.