CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bmi-bsa-calculator

Calculate Body Mass Index (BMI) and Body Surface Area (BSA) for clinical assessment, obesity screening, and chemotherapy dosing. Supports multiple BSA formulas (DuBois, Mosteller, Haycock), WHO weight classification, pediatric calculations, and metric/imperial input.

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/bmi-bsa-calculator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

60%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 skill body is well-organized and its CLI documentation is accurate and executable, but the core Python examples describe an API that the bundle does not implement, and every detailed reference file the body points to is missing. The document reads as a spec for a larger toolkit that was never shipped alongside it.

Suggestions

Create the four referenced files (references/bsa_formulas_comparison.md, pediatric_norms.md, chemotherapy_dosing.md, ethnic_adjustments.md) or remove the References section and inline the essential details.

Fix the Python examples to match the actual script: 'from scripts.main import BMIBSACalculator' with calc.calculate(weight_kg, height_cm) and calc.calculate_dose(bsa, dose_mg), or add a scripts/calculator.py implementing the documented API.

State explicitly that only the DuBois BSA formula is implemented, or extend main.py to support the other formulas and pediatric percentile calculation advertised in the body.

DimensionReasoningScore

Conciseness

The body is efficient: compact tables for BMI categories, formulas, and CLI parameters, with no padding explaining what BMI is or how Python works. Minor trimming opportunities exist — the 'Key Capabilities' bullet list duplicates the frontmatter description, and the valid ranges (weight 2–300 kg, height 50–250 cm) are stated twice, in 'Input Validation' and again in 'Error Handling'. This matches the anchor 'Efficient; minor instances of over-explanation that could be trimmed', not level 5 where every token earns its place.

4 / 5

Actionability

The CLI section is genuinely executable and matches the bundled main.py (flags --weight/--height/--dose/--format/--output are all real), but the four 'Core Capabilities' Python blocks are not: 'from scripts.calculator import BMIBSACalculator' imports a module that does not exist (scripts/ contains only main.py), and 'calc.calculate_bmi(...)', 'calc.calculate_bsa(..., formulas=[...])', 'calc.calculate_dose(bsa=..., drug=..., dose_per_m2=..., max_dose=...)', and 'calc.pediatric_mode(...)' do not match the actual API (calculate(weight, height) and calculate_dose(bsa, standard_dose_mg)). Only DuBois is implemented, yet Mosteller/Haycock/Gehan-George are presented as working options. This is 'Some concrete guidance but incomplete... missing key details' (level 3) rather than level 4's 'minor gaps' — a large share of the examples fail against the real bundle.

3 / 5

Workflow Clarity

The Workflow section gives a clear 5-step sequence with an explicit validation checkpoint ('Validate inputs are within physiologically plausible ranges; stop if values are outside bounds'), a fallback path with exact response text, a Quick Check smoke command, and a dedicated Error Handling section. It falls short of level 5 because the promised 'manual calculation fallback' is named but never specified, and there is no fix-and-retry loop — matching 'Clear sequence with most checkpoints present; minor validation gaps'.

4 / 5

Progressive Disclosure

Section structure inside SKILL.md is good (overview, workflow, capabilities, CLI, parameters, pitfalls, limitations), but the reference layer is broken: all four files cited under References — 'references/bsa_formulas_comparison.md', 'references/pediatric_norms.md', 'references/chemotherapy_dosing.md', 'references/ethnic_adjustments.md' — do not exist in the bundle (references/ contains only an unreferenced guidelines.md), and the body likewise points to the nonexistent scripts/calculator.py. Scored against the actual bundle per the judging guideline, every signposted path to deeper content dead-ends, which is noticeably below the midpoint — inlining that detail or shipping the files is required to reach level 3.

2 / 5

Total

13

/

20

Passed

Description

82%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, well-scoped description with excellent natural trigger terms and low conflict risk. Its only notable weakness is the absence of an explicit 'Use when...' clause, which leaves invocation guidance implicit and caps completeness at 3.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user provides weight and height values, asks for BMI, BSA, body surface area for drug dosing, or obesity screening.'

Consider mentioning the extension/format context users may reference (e.g. metric or imperial units in a request) to strengthen the natural trigger coverage.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with specifics: 'Calculate Body Mass Index (BMI) and Body Surface Area (BSA)', 'Supports multiple BSA formulas (DuBois, Mosteller, Haycock)', 'WHO weight classification, pediatric calculations, and metric/imperial input'. Naming the actual formulas and classification systems gives comprehensive, non-generic coverage of the skill's capabilities — matching the anchor 'Lists multiple specific concrete actions; comprehensive coverage', not the level-4 anchor which requires minor coverage gaps.

5 / 5

Completeness

The 'what' is clearly answered (calculate BMI/BSA with named formulas and classifications), but there is no 'Use when...' clause or equivalent explicit trigger guidance — the phrase 'for clinical assessment, obesity screening, and chemotherapy dosing' only weakly implies when to invoke the skill. Per the judging guideline, a missing 'Use when...' clause caps completeness at 3, which matches the anchor 'Has a clear what but when is missing or only weakly implied'. Not 4 because the when-guidance is absent rather than merely under-specified.

3 / 5

Trigger Term Quality

Natural trigger terms users would actually say are all present: 'BMI'/'Body Mass Index', 'BSA'/'Body Surface Area', 'obesity screening', 'chemotherapy dosing', 'pediatric calculations', 'metric/imperial input'. Both abbreviations and full names are covered (synonym coverage), and these are the exact phrases a user needing this skill would type. Not level 4 because no common natural variation of the domain terms is missing.

5 / 5

Distinctiveness Conflict Risk

BMI/BSA calculation is a clear niche with highly distinctive triggers ('BMI', 'BSA', 'chemotherapy dosing') that no generic document- or code-processing skill would match, giving minimal conflict risk. It is above the level-4 anchor ('minor overlap risk with closely related skills') because the named formulas and WHO classification further pin it to this specific clinical calculation task rather than a broader medical-calculator category.

5 / 5

Total

18

/

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

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 4 missing

Warning

Total

14

/

16

Passed

Repository

aipoch/medical-research-skills

Path

scientific-skills/Other/bmi-bsa-calculator/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.