← Back to Skills Marketplace
aaronn

Huckleberry

by aaronn · GitHub ↗ · v0.1.0
cross-platform ⚠ suspicious
1607
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install openclaw-huckleberry-skill
Description
Track baby sleep, feeding, diapers, and growth via Huckleberry app API. Use for logging baby activities through natural language.
Usage Guidance
What to consider before installing: - The SKILL.md and code require HUCKLEBERRY_EMAIL/HUCKLEBERRY_PASSWORD or a credentials file (~/.config/huckleberry/credentials.json); the registry metadata does not list these — expect to supply secrets if you use it. - The script imports google.cloud.firestore and directly reads/writes Firestore documents (api._get_firestore_client()). That may cause the script to use Google Application Default Credentials (GOOGLE_APPLICATION_CREDENTIALS or gcloud user creds) if they exist — be careful: it can access other Google project credentials present on the host. - The package installation is a pip install from a GitHub repo (not a vetted PyPI release). Review the upstream py-huckleberry-api repo and the included scripts/hb.py source yourself before installing. - If you decide to use it: run in an isolated environment (dedicated VM/container or virtualenv), create a Huckleberry account with least-privilege credentials, avoid reusing sensitive Google credentials, and inspect the code paths that call Firestore to ensure writes are intended. - If you need a cleaner trust boundary, request the publisher add explicit metadata for required env vars/config paths and document the Firestore usage (why direct Firestore access is necessary) so you can assess risk more precisely.
Capability Analysis
Type: OpenClaw Skill Name: openclaw-huckleberry-skill Version: 0.1.0 This skill is classified as suspicious due to its reliance on a reverse-engineered API client (`py-huckleberry-api` from GitHub) and its direct interaction with Google Cloud Firestore. While the current implementation uses Firestore for benign purposes (extending note functionality and precise sleep logging), this direct, low-level access to the backend data store (as seen in `scripts/hb.py` via `api._get_firestore_client()` and `add_notes_to_latest_interval()`) represents a powerful capability that, if misused, could lead to unauthorized data manipulation or exfiltration. The installation from a GitHub URL also introduces a supply chain risk. There is no clear evidence of intentional malicious behavior, but these risky capabilities warrant a 'suspicious' classification.
Capability Assessment
Purpose & Capability
Name/description claim to log baby activities via Huckleberry API which matches the included CLI. However the code also imports and uses google.cloud.firestore and calls api._get_firestore_client() to read/write Firestore documents directly — a capability not declared in the skill metadata (no required env vars or config paths were listed). The direct Firestore access is more powerful than a simple API wrapper and is not reflected in the registry metadata.
Instruction Scope
SKILL.md and the script instruct the agent to read credentials from environment variables or ~/.config/huckleberry/credentials.json and to install a GitHub-hosted Python package. The code performs direct Firestore reads/writes (bypassing a documented external service endpoint) and will attempt to use Google Application Default Credentials if present — this expands scope to include local config and cloud credentials beyond the Huckleberry username/password.
Install Mechanism
There is no registry install spec, but SKILL.md asks to pip install a GitHub repository (git+https://github.com/Woyken/py-huckleberry-api.git). Installing a package directly from a GitHub repo is common but higher-risk than a vetted PyPI release because it pulls arbitrary code from that repo.
Credentials
The repository metadata declared no required environment variables or config paths, yet SKILL.md and scripts require HUCKLEBERRY_EMAIL and HUCKLEBERRY_PASSWORD (or a credentials file) and the code may rely on Google Cloud credentials (ADC) for Firestore access. Required secrets are not declared in the skill metadata and additional implicit credential surfaces (Google Application Default Credentials, local config) exist.
Persistence & Privilege
always is false and the skill does not request system-wide persistent installation in the registry. The script will read/write a credentials file under the user's home (~/.config/huckleberry) and may access Google Cloud ADC, but it does not modify other skills or request elevated platform-wide privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install openclaw-huckleberry-skill
  3. After installation, invoke the skill by name or use /openclaw-huckleberry-skill
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release of the huckleberry baby activity tracking skill. - Enables tracking of baby sleep, feeding (breast and bottle), diapers, and growth via the Huckleberry app's API and CLI tools. - Supports logging via natural language with built-in follow-up prompts for missing details (e.g., bottle amount, diaper type). - Provides agent guidelines to always include AI attribution in notes for logging actions. - Offers detailed CLI usage examples and a comprehensive parameter reference for all activity types. - Allows flexible setup: environment variables or config file for credentials, with easy pip installation.
Metadata
Slug openclaw-huckleberry-skill
Version 0.1.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Huckleberry?

Track baby sleep, feeding, diapers, and growth via Huckleberry app API. Use for logging baby activities through natural language. It is an AI Agent Skill for Claude Code / OpenClaw, with 1607 downloads so far.

How do I install Huckleberry?

Run "/install openclaw-huckleberry-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Huckleberry free?

Yes, Huckleberry is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Huckleberry support?

Huckleberry is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Huckleberry?

It is built and maintained by aaronn (@aaronn); the current version is v0.1.0.

💬 Comments