# Send Huckleberry to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "openclaw-huckleberry-skill", "name": "Huckleberry", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/aaronn/openclaw-huckleberry-skill", "canonicalUrl": "https://clawhub.ai/aaronn/openclaw-huckleberry-skill", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/openclaw-huckleberry-skill", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-huckleberry-skill", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "scripts/hb.py" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/openclaw-huckleberry-skill" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/openclaw-huckleberry-skill", "downloadUrl": "https://openagent3.xyz/downloads/openclaw-huckleberry-skill", "agentUrl": "https://openagent3.xyz/skills/openclaw-huckleberry-skill/agent", "manifestUrl": "https://openagent3.xyz/skills/openclaw-huckleberry-skill/agent.json", "briefUrl": "https://openagent3.xyz/skills/openclaw-huckleberry-skill/agent.md" } } ``` ## Documentation ### Huckleberry Baby Tracker Track baby activities (sleep, feeding, diapers, growth) via the Huckleberry app's Firebase backend. ### Setup Install the API: # Install from GitHub (required for bottle feeding support until next PyPI release) pip install git+https://github.com/Woyken/py-huckleberry-api.git # or with uv: uv pip install git+https://github.com/Woyken/py-huckleberry-api.git Configure credentials (choose one): Environment variables: export HUCKLEBERRY_EMAIL="your-email@example.com" export HUCKLEBERRY_PASSWORD="your-password" export HUCKLEBERRY_TIMEZONE="America/Los_Angeles" # optional Config file at ~/.config/huckleberry/credentials.json: { "email": "your-email@example.com", "password": "your-password", "timezone": "America/Los_Angeles" } ### CLI Usage The CLI is at ~/clawd/skills/huckleberry/scripts/hb.py # List children python3 ~/clawd/skills/huckleberry/scripts/hb.py children # Sleep tracking python3 ~/clawd/skills/huckleberry/scripts/hb.py sleep-start python3 ~/clawd/skills/huckleberry/scripts/hb.py sleep-pause python3 ~/clawd/skills/huckleberry/scripts/hb.py sleep-resume python3 ~/clawd/skills/huckleberry/scripts/hb.py sleep-complete python3 ~/clawd/skills/huckleberry/scripts/hb.py sleep-cancel # Breastfeeding python3 ~/clawd/skills/huckleberry/scripts/hb.py feed-start --side left python3 ~/clawd/skills/huckleberry/scripts/hb.py feed-switch python3 ~/clawd/skills/huckleberry/scripts/hb.py feed-pause python3 ~/clawd/skills/huckleberry/scripts/hb.py feed-resume --side right python3 ~/clawd/skills/huckleberry/scripts/hb.py feed-complete python3 ~/clawd/skills/huckleberry/scripts/hb.py feed-cancel # Bottle feeding python3 ~/clawd/skills/huckleberry/scripts/hb.py bottle 120 --type "Formula" --units ml # Diaper python3 ~/clawd/skills/huckleberry/scripts/hb.py diaper both --pee-amount medium --poo-amount big --color yellow --consistency loose # Growth python3 ~/clawd/skills/huckleberry/scripts/hb.py growth --weight 5.2 --height 55 --head 38 --units metric python3 ~/clawd/skills/huckleberry/scripts/hb.py growth-get # History python3 ~/clawd/skills/huckleberry/scripts/hb.py history --date 2026-01-27 python3 ~/clawd/skills/huckleberry/scripts/hb.py history --days 7 --type sleep --type feed python3 ~/clawd/skills/huckleberry/scripts/hb.py history --json ### Sleep Commands CommandParametersDescriptionsleep-start—Start a new sleep session (timer begins)sleep-pause—Pause the current sleep sessionsleep-resume—Resume a paused sleep sessionsleep-complete--notesEnd sleep and save to historysleep-cancel—Cancel without saving to history ### Breastfeeding Commands CommandParametersDescriptionfeed-start--side {left,right} (default: left)Start nursing sessionfeed-pause—Pause session, accumulate durationfeed-resume--side {left,right} (optional)Resume on specified or last sidefeed-switch—Switch to other side (auto-resumes if paused)feed-complete--notesEnd session and save to historyfeed-cancel—Cancel without saving ### Bottle Feeding bottle [options] ParameterValuesRequiredDefaultamountAny numberYes—--type / -t"Breast Milk", "Formula", "Mixed"No"Formula"--units / -uml, ozNoml--notes / -nAny textNo— ### Diaper Change diaper [options] ParameterValuesRequiredDefaultmodepee, poo, both, dryYes—--pee-amountlittle, medium, bigNo—--poo-amountlittle, medium, bigNo—--coloryellow, brown, black, green, red, grayNo—--consistencysolid, loose, runny, mucousy, hard, pebbles, diarrheaNo—--rash(flag)Nofalse--notesAny textNo— Color Guide yellow — Normal for breastfed babies brown — Normal for formula-fed or older babies green — Can be normal, or indicate fast digestion/foremilk black — Normal first few days (meconium), concerning later red — May indicate blood, consult pediatrician gray — Uncommon, may indicate liver issues Consistency Guide solid — Formed stool loose — Soft but not watery runny — Watery consistency mucousy — Contains mucus hard — Firm, may indicate constipation pebbles — Small hard pieces diarrhea — Very watery, frequent ### Growth Measurements growth [options] growth-get ParameterValuesRequiredNotes--weight / -wNumberAt least onekg (metric) or lbs (imperial)--height / -lNumbermeasurementcm (metric) or inches (imperial)--headNumberrequiredcm (metric) or inches (imperial)--units / -umetric, imperialNoDefault: metric--notes / -nAny textNo— ### History / Calendar history [options] ParameterValuesRequiredDefault--date / -dYYYY-MM-DDNoToday--daysNumberNo1--type / -tsleep, feed, diaper, healthNoAll types Use --type multiple times to filter: --type sleep --type feed ### AI Attribution on Notes Always include AI attribution when logging entries: Creating new entries: No user note: --notes "Created via AI" User provides note: --notes "user's note | Created via AI" Editing existing entries: No user note: --notes "Updated via AI" User provides note: append | Updated via AI to existing notes This creates a paper trail for AI-assisted entries. ### When to Ask for Clarification When a user request is sparse, ask for clarification before logging. Here's when: ### Diaper Changes If user says just "diaper change" or "poop": Always ask: Was it pee, poo, or both? For poo, consider asking: Color? Consistency? Amount? Skip details if: User seems rushed or says "just log it" Example follow-up: "Got it! Was it pee, poo, or both? Any details to note (color, consistency, amount)?" ### Bottle Feeding If user says "bottle" without amount: Always ask: How much? (in ml or oz) Consider asking: Formula, breast milk, or mixed? Example follow-up: "How much was the bottle? And was it formula, breast milk, or mixed?" ### Growth Measurements If user says "log weight" without value: Always ask: What's the weight? (and clarify units if ambiguous) ### Sleep/Feeding Timers These are typically clear commands, but clarify if ambiguous: "Baby's eating" → "Starting breastfeeding — which side, left or right?" "Feed done" → Check if breastfeeding or bottle context ### Natural Language Examples User saysAction"Baby fell asleep"sleep-start"She woke up"sleep-complete"Cancel that sleep"sleep-cancel"Feeding on the left"feed-start --side left"Switch sides"feed-switch"Done nursing"feed-complete"4oz bottle of formula"bottle 4 --type Formula --units oz"120ml breast milk bottle"bottle 120 --type "Breast Milk" --units ml"Diaper change, pee and poo"→ Ask about amounts/color/consistency"Just a wet diaper"diaper pee"Dry check"diaper dry"Weight is 5.5kg"growth --weight 5.5 --units metric"What did the baby do today?"history --days 1"Sleep history for the week"history --days 7 --type sleep ### Multi-Child Support If the account has multiple children, use --child / -c: python3 hb.py --child "Baby Name" sleep-start Without --child, commands default to the first child in the account. ### Troubleshooting Authentication errors: Verify email/password are correct Check credentials file permissions Huckleberry doesn't support 2FA for API access "No children found": Ensure the account has at least one child profile in the Huckleberry app Timer already active: Complete or cancel the existing session before starting a new one ### Technical Notes Uses Firebase Firestore via gRPC (same as mobile app) Real-time sync: Changes appear immediately in the Huckleberry app Token auto-refresh: Sessions stay authenticated Timezone handling: Huckleberry requires an offset field (minutes behind UTC) for entries to display correctly. E.g., PST (UTC-8) = 480 minutes. The CLI automatically calculates this from the configured timezone. Without this field, entries appear at UTC time in the app. ### Credits Built on py-huckleberry-api by Woyken — a reverse-engineered Python client for Huckleberry's Firebase backend. Created with AI - 2026-01-27 Updated with AI - 2026-01-28 ### Notes on All Entry Types The --notes / -n parameter is available on all entry types: sleep-complete --notes "Slept through the night!" feed-complete --notes "Good latch today" bottle --notes "Logged via AI" diaper --notes "Checked by AI" growth --notes "Measured at pediatrician" The upstream py-huckleberry-api only supports notes on diaper entries. This skill extends that to all types by updating the Firestore document directly after creation. ### Not Supported by Upstream API The following features exist in Huckleberry but aren't exposed in the py-huckleberry-api: Sleep conditions (happy/upset at start/end) Sleep locations (car, nursing, stroller, crib, etc.) These would require modifying the upstream library to accept additional parameters. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: aaronn - Version: 0.1.0 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-30T16:55:25.780Z - Expires at: 2026-05-07T16:55:25.780Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/openclaw-huckleberry-skill) - [Send to Agent page](https://openagent3.xyz/skills/openclaw-huckleberry-skill/agent) - [JSON manifest](https://openagent3.xyz/skills/openclaw-huckleberry-skill/agent.json) - [Markdown brief](https://openagent3.xyz/skills/openclaw-huckleberry-skill/agent.md) - [Download page](https://openagent3.xyz/downloads/openclaw-huckleberry-skill)