Pp Function Health

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/other/function-health/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

Function Health — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the function-health-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer:

   npx -y @mvanhorn/printing-press-library install function-health --cli-only

2. Verify: function-health-pp-cli --version
3. Ensure $GOPATH/bin (or $HOME/go/bin) is on $PATH.

If the npx install fails before this CLI has a public-library category, install Node or use the category-specific Go fallback after publish.

If --version reports "command not found" after install, the install step did not put the binary on $PATH. Do not proceed with skill commands until verification succeeds.

Function Health gives you a great single-round dashboard but no way to see what's drifting across years of draws — and no way to share a clean, branded lab history with your physician. function-health-pp-cli pulls every round into a local SQLite store with FTS5, exposes cross-round trend analysis nobody else offers (goat, biomarker trend, biomarkers trending, biomarkers oscillating), and renders a Function-branded PDF with your name and date of birth that an MD can read in 30 seconds.

When to Use This CLI

Reach for function-health-pp-cli whenever an agent is asked to reason about lab trends over time, to prioritize which biomarker the user should worry about, or to produce an artifact a clinician will actually read. It is the right tool when the question requires joining data across multiple test rounds, when the user wants a branded PDF for a doctor, or when an agent needs a focused Markdown context block for one biomarker rather than the entire JSON export. It is the wrong tool for one-off single-result lookups on a draw that hasn't been synced yet — for those, run sync first or query the Function web app directly.

When Not to Use This CLI

Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Doctor-ready outputs

• export pdf-for-doctor — Render a Function-branded multi-round lab report PDF with your name and date of birth, suitable for emailing to your personal physician.

  When an agent needs to produce something the user will hand to a third party, this is the durable artifact — not a JSON blob.

  function-health-pp-cli export pdf-for-doctor --out ~/Downloads/function-history.pdf

Local-SQL trend analysis

• biomarker trend — Every value of a biomarker across every round you've ever drawn, with the delta from Function's optimal range, an ASCII sparkline in the terminal, and structured JSON for agents.

  When the agent is asked 'how has X changed', this is the one query that answers it without re-fetching anything.

  function-health-pp-cli biomarker trend ApoB --json

• goat — Ranks every biomarker by distance-from-optimal multiplied by its slope-away-from-optimal across the last 3 rounds; returns the single most worrying biomarker right now with reasoning fields.

  When the agent is asked 'what should I worry about', this is the one-call answer.

  function-health-pp-cli goat --agent

• biomarkers trending — Lists every biomarker whose slope across the last N rounds points away from Function's optimal range, sorted by magnitude.

  Lets the agent prioritize a long biomarker list without burning the user's context window on every reading.

  function-health-pp-cli biomarkers trending --direction worse --last 3 --json

• category trend — For one of the ~13 categories, returns a per-round aggregate score (percent of biomarkers inside Function's optimal range) over time.

  Rolls up 100+ biomarkers into a single trajectory per body system, so the agent can summarize organ-level changes.

  function-health-pp-cli category trend cardiovascular --json

• biomarkers oscillating — Biomarkers that crossed the optimal-range boundary at least twice in the last N rounds — flags instability separate from trend.

  Distinguishes 'unstable measurement noise' from 'consistently bad' — important when the agent is reasoning about whether a single high reading matters.

  function-health-pp-cli biomarkers oscillating --rounds 4

• recommendations stale — Recommendations (supplements / foods) whose target biomarker is STILL outside Function's optimal range, joined by Quest code. The /recommendations endpoint has no issued-date, so staleness is by outcome not age; --min-rounds tightens to persistence and --group (supplements, foods_to_eat, foods_to_avoid) focuses a large set.

  Closes the loop between guidance and outcome — the agent can ask 'did the last fix work?' instead of 'what is recommended now?'.

  function-health-pp-cli recommendations stale --json

Agent-native plumbing

• bundle — Composes a single Markdown file with a biomarker's full history, every clinician note mentioning it (FTS5), Function's optimal range, and relevant recommendations — ready to paste into Claude or ChatGPT.

  When the agent is being asked to draft a question for the user's clinician, this is the prefab context block.

  function-health-pp-cli bundle ApoB --window 3rounds

Command Reference

biological_age — Biological-age and BMI calculations Function derives from your panels.

• function-health-pp-cli biological-age bio-age — Your biological age vs. chronological age. 404 if not yet calculated.
• function-health-pp-cli biological-age bmi — BMI with the weight and height inputs Function recorded.

biomarkers — Function Health's full biomarker catalog with names, units, reference ranges, and Function's "optimal" ranges.

• function-health-pp-cli biomarkers get — Get one biomarker's full result history across every round you've drawn, with values, units, status, and ranges.
• function-health-pp-cli biomarkers list — List every biomarker the platform knows about (across all categories).

categories — The ~13 medical categories biomarkers are organized into (Heart, Hormones, Thyroid, Metabolic, Liver, Kidney, etc.).

• function-health-pp-cli categories — List every biomarker category with the biomarkers nested under it.

notes — Clinician notes attached to your results.

• function-health-pp-cli notes — List all clinician notes (annotations on biomarkers / rounds).

notifications — Change notifications (new results landing, biomarker direction changes).

• function-health-pp-cli notifications — Read all unread/read notifications about result changes.

recommendations — Personalized health recommendations tied to your results.

• function-health-pp-cli recommendations — Per-category health guidance. May 404 if Function hasn't computed any yet.

requisitions — Lab requisitions — pending (in-progress draws) and completed (rounds with results).

• function-health-pp-cli requisitions completed — Completed requisitions (your past test rounds, keyed by requisitionId).
• function-health-pp-cli requisitions pending — Currently in-progress requisitions (lab orders awaiting completion).

results — Lab results — both the structured biomarker-level data and the raw requisition documents.

• function-health-pp-cli results list — Raw requisition / PDF result data (less useful for queries; see results-report for structured values).
• function-health-pp-cli results report — The structured lab-results report — every biomarker, every round, with value, unit, status, Quest reference range

schedules — Upcoming scheduled lab-draw appointments.

• function-health-pp-cli schedules — Upcoming scheduled lab visits you've booked.

user — Your Function Health member profile (id, name, contact info, membership status).

• function-health-pp-cli user — Get the authenticated member profile. Used by doctor for reachability + auth check.

visits — Individual lab-collection events within a test round.

• function-health-pp-cli visits — List every visit (draw event) — useful when a round has multiple draws.

wearables — Wearable-device integrations (Apple Health, Garmin, Whoop, Oura, etc.).

• function-health-pp-cli wearables — List the wearable apps Function currently supports for integration.

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

function-health-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.