Lab Result Interpretation

What it does

When your agent uses it

• Research & Science work in your project

Example prompts

• “Use the lab-result-interpretation skill to transform biochemical lab test results into clear, patient-friendly explanations”
• “/lab-result-interpretation”

Requirements

• Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

1. 1Parse lab report — Input: lab result text or file (--file/--input) → extract test names, values, units, reference ranges using regex…
2. 2Compare to reference ranges — Match each test against references/lab_reference_ranges.json → determine status (normal/high/low) → Output…
3. 3Assess severity — Classify: mild (slightly outside range), moderate (clinically significant deviation), critical (requires immediate…
4. 4Generate explanations — For each abnormal value: explain what the test measures, what the deviation means, contextual health information →…
5. 5Format output — Combine all results into structured JSON with test_name, value, status, explanation, severity, recommendation → include…

What it can do on your machine

Read from SKILL.md and the folder at commit 686e09d. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 1 file in scripts/ (Python), which the agent can run.

  Shell commands in SKILL.md call:

  • python

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Lab Result Interpretation loads about 2.1k tokens when it runs, and up to ~6.4k if it reads all its reference files. Until then it costs about 77 tokens; SKILL.md has 817 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~77

When it runs · the whole SKILL.md, loaded when a task matches

~2.1k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~6.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from aipoch/medical-research-skills at commit 686e09d, republished under its MIT licence (© aipoch). 817 words, ~2,096 tokens.

name

lab-result-interpretation

description

Transforms biochemical lab test results into clear, patient-friendly explanations. Covers blood routine, lipid panel, liver/kidney function, thyroid, electrolytes, and inflammation markers. Flags critical values, classifies severity, and generates structured interpretation rep...

license

MIT

author

AIPOCH

python -m py_compile scripts/main.py

python -m py_compile scripts/main.py
python scripts/main.py --help

from scripts.main import LabResultInterpreter

interpreter = LabResultInterpreter()
result = interpreter.interpret("Total Cholesterol: 5.8 mmol/L (Reference: 3.1-5.7)")
print(result.explanation)

python scripts/main.py --file lab_report.txt
python scripts/main.py --interactive

Test Name: Value Unit (Reference: Min-Max)
Test Name Value Unit Ref: Min-Max
Test Name: Value (Min-Max)

{
  "test_name": "Total Cholesterol",
  "value": 5.8,
  "unit": "mmol/L",
  "reference_min": 3.1,
  "reference_max": 5.7,
  "status": "high",
  "explanation": "Your total cholesterol is slightly above the normal range...",
  "severity": "mild",
  "recommendation": "Consider reducing saturated fat intake..."
}

# Python dependencies
pip install -r requirements.txt

© aipoch, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (scripts, references) in scientific-skills/Other/lab-result-interpretation of aipoch/medical-research-skills.

• SKILL.md
• POLISH_CHANGELOG.md
• eval_report_lab-result-interpretation_result.json
• references/explanation_templates.json
• references/lab_reference_ranges.json
• requirements.txt
• scripts/main.py

Open the folder on GitHubat commit 686e09d