CareMax Health Indicators

Requires caremax-auth as a sibling directory (../caremax-auth/, same layout as skills/caremax-auth + skills/caremax-indicators in this repo, or under ~/.agents/skills/). If missing: npx skills add KittenYang/caremax-skills and select caremax-auth.

What end users can do (plain language)

• - Browse and analyze their saved indicators: lists, categories, trends over time (labs and long-term metrics).
• Quickly add a single reading for common day-to-day metrics — the same idea as the app’s 「快捷记一笔」: pick a familiar item (often things like 身高、体重、血压、心率、体温、腰围等，具体有哪些以当前账号下列出的可选项为准), enter a value and date, and it is stored like a normal indicator data point. No upload or report file required.

Agents should describe this in user-friendly terms (“帮你记一笔今天的体重”“看看现在能快捷记录哪些项目”) and only use the API steps below to implement it after the user is authenticated.

This skill also covers the agent/skill indicator endpoints under /api/skill/indicators/* for listing, categories, and trends.

Prerequisites — Auto-Auth (MANDATORY)

Working directory: this skill’s root folder (caremax-indicators/, sibling of caremax-auth/). Scripts in auth are reached with ../caremax-auth/scripts/.

CODEBLOCK0

If any script returns {"error":"no_credentials",...} → immediately run bash ../caremax-auth/scripts/auth-flow.sh [base_url] in background. If the user specified a custom URL (e.g., http://localhost:8788), pass it as the argument. It opens the browser and auto-polls. Tell the user "please authorize in browser". Once it outputs authorized, retry.

List All Indicators

CODEBLOCK1

Response fields: id (UUID, needed for trend), canonical_name, display_name, canonical_unit, category, latest_value, INLINECODE20

Get Indicator Categories

CODEBLOCK2

Get Indicator Trend

Important: Get the indicator UUID from the list endpoint first.

CODEBLOCK3

Returns time-series: date, value, unit, reference_range, is_abnormal (0/1)

Quick log — same feature as 「快捷记一笔」 (authenticated user only)

Prefer the dedicated scripts (wrap api-call.sh with the same OAuth user token). Do not hand-roll curl.

Typical user intents: “记一下体重 70”“今天身高 175”“帮妈妈记血压 120/80” — always run list-system-presets.sh first so you use a valid preset_key and know default units; use --member when logging for a family profile.

1) List what the user can quick-log right now

CODEBLOCK4

Response: presets[] — use preset_key for quick-log.sh; show display_name / canonical_unit when confirming with the user. Do not assume a fixed list of metrics in prose.

2) Save one value

CODEBLOCK5

• - Positional: preset_key, value (required).
• Optional: --unit, --date YYYY-MM-DD (omit date → server default today), --member (family member UUID).

Lower-level equivalent (only if you need custom JSON)

CODEBLOCK6

Recommended workflow (quick log)

CODEBLOCK7

Get Trends by Category

CODEBLOCK8

Recommended Workflow

When user asks "show my creatinine trend":

CODEBLOCK9

When user asks "what are my abnormal indicators":

CODEBLOCK10

Display Guidelines

• - Always show values with units (e.g., "98 μmol/L" not just "98")
• Include reference ranges when available
• Flag abnormal values clearly
• For trends, show dates in chronological order
• Chinese indicator names are standard — display them as-is