Skip to content

v0.1.0

Choose a tag to compare

@smallinaUCSD smallinaUCSD released this 02 Jul 17:29
· 13 commits to main since this release

v0.1.0

First public release of growth-percentile-skill: an open-source Agent
Skill that computes pediatric growth percentiles and z-scores against
CDC and WHO growth standards, from FHIR, Synthea, or flat-file patient
data — using a frozen, tested, deterministic engine instead of model
arithmetic.

Engine

  • Cole's LMS method against real CDC 2000, CDC 2022 extended-BMI, and
    WHO 2006 reference tables (checksummed, cited, downloaded from source).
  • Automatic WHO-vs-CDC reference selection at the 24-month boundary.
  • CDC's extended-BMI method for severe obesity and modified-z-score
    method for flagging biologically implausible values — both
    independently verified against CDC's own published worked examples
    (see references/METHODOLOGY.md).
  • Unit conversion, weight-for-length/stature pairing, derived-BMI,
    prematurity flagging (flag-only in v1 — see scope notes).

Ingestion

  • Three adapters: FHIR R4, Synthea CSV export, flat CSV/JSON.
  • Tested against real Synthea-generated patient data (FHIR bundle and
    CSV export), not hand-written fixtures — including the discovery that
    Synthea (and much real-world data) uses an ambiguous LOINC code for
    body length/height, resolved with a documented age-based heuristic.

Trust

  • 68 unit/integration tests, all passing, including frozen golden test
    vectors (tests/golden/) protected by CODEOWNERS and a checksum gate.
  • An agent-behavioral eval suite (evals/, EVALUATION.md) — real
    Claude subagents run against 5 scenarios. One failed on first run (an
    agent hand-computed out-of-scope growth-velocity math despite a
    caveat); the SKILL.md guardrail was fixed and re-verified. Both the
    failing and fixed responses are committed for auditability.

Distribution

  • Installable as a Claude Code plugin (.claude-plugin/plugin.json +
    marketplace.json, verified against a live install/uninstall cycle)
    or as a drop-in skill directory for any skill-compatible agent.

Scope (v1)

Weight/length/height/BMI/head-circumference-for-age, ages 0-20 years.
Does not correct for prematurity, apply condition-specific charts, or
compute growth velocity/trend — see references/METHODOLOGY.md §6-7.
Not a diagnostic tool or a substitute for clinical judgment; not FDA
cleared.

See CHANGELOG.md for the full file-by-file list.