← Back to Skills Marketplace
sparky
by
aronjanosch
· GitHub ↗
· v0.3.1
· MIT-0
170
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install sparky
Description
SparkyFitness CLI for food diary, exercise tracking, biometric check-ins, and health summaries.
Usage Guidance
This skill is mostly coherent for controlling a local 'sparky' CLI, but verify provenance before installing or running any downloaded binary. Specifically:
- Confirm which GitHub project/release is authoritative — SKILL.md references aronjanosch/sparky-cli while registry metadata points at CodeWithCJ; ask the publisher or check the linked repos to ensure you download the intended project.
- If you install a prebuilt binary, verify checksums/signatures from the official release page and prefer building from source if you can audit it.
- The examples use tools like jq, git, go, brew and sudo; ensure those tools are present and trustworthy on your system.
- The CLI will ask you to set a server URL and API key (sparky config set-url / set-key). Treat those values as sensitive: only provide them to a server you control or trust.
- Because this is an instruction-only skill, the platform won’t install code itself — the primary risk is running an unfamiliar binary locally. If you’re unsure, run the binary in a sandbox or inspect/build from source before use.
If you can provide the exact repository you expect this skill to reference (or the publisher confirm the correct homepage), I can re-evaluate with higher confidence.
Capability Analysis
Type: OpenClaw Skill
Name: sparky
Version: 0.3.1
The skill provides a legitimate interface for the SparkyFitness CLI, allowing an agent to log food, exercise, and biometrics to a self-hosted server. The instructions in SKILL.md are well-documented, focusing on functional usage and agentic precision (e.g., using JSON flags and IDs), with no evidence of malicious intent, data exfiltration, or prompt injection.
Capability Assessment
Purpose & Capability
The skill claims to be a SparkyFitness CLI and the instructions focus on using a local 'sparky' binary to talk to a self-hosted server — that is coherent. However the registry metadata lists homepage https://github.com/CodeWithCJ/SparkyFitness while the SKILL.md references aronjanosch/sparky-cli (brew tap, releases). This source/homepage mismatch is unexplained and could indicate a packaging or provenance problem.
Instruction Scope
SKILL.md contains detailed CLI usage and agentic workflows that stay within the stated purpose (searching/logging food, exercise, check-ins). A few examples reference other tools (jq, git, go, sudo, brew) for install or JSON parsing, but those binaries are not declared in the skill metadata — this is a minor mismatch but not obviously malicious. The instructions do not ask the agent to read unrelated files or environment variables.
Install Mechanism
This is an instruction-only skill (no install spec) so nothing is installed by the platform itself. The SKILL.md mentions installing prebuilt binaries or building from source using GitHub releases/Go; these are standard but require the user to verify release authenticity (checksums/signatures) because binaries will be placed on disk.
Credentials
The skill declares no required environment variables or credentials. That aligns with the README-style instructions which show the CLI storing a URL/key via 'sparky config'. Be aware that the CLI itself will ask for a server URL and API key (entered by the user) — those secrets are not requested by the skill metadata but will be used by the binary at runtime.
Persistence & Privilege
always:false and model invocation is allowed (defaults). The skill does not request elevated persistence or modify other skills. It's an agent-invocable helper that runs local CLI commands — typical for this class of skill.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install sparky - After installation, invoke the skill by name or use
/sparky - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.3.1
v0.3.1: Add food create command (custom foods with full macro/nutrient support, --serving-size/unit, --brand); fix food remove to use UUID instead of external_id; add exercise --notes flag; various bugfixes
v0.3.0
v0.3.0: Add --barcode lookup, --pick N selector, food remove command, brand column in search, --id flag for unambiguous logging, --external search flag, sets/reps/weight/RPE for exercise, is_local field in search results
v1.0.0
Initial release
Metadata
Frequently Asked Questions
What is sparky?
SparkyFitness CLI for food diary, exercise tracking, biometric check-ins, and health summaries. It is an AI Agent Skill for Claude Code / OpenClaw, with 170 downloads so far.
How do I install sparky?
Run "/install sparky" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is sparky free?
Yes, sparky is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does sparky support?
sparky is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created sparky?
It is built and maintained by aronjanosch (@aronjanosch); the current version is v0.3.1.
More Skills