← Back to Skills Marketplace
rstierli

Nanoleaf (Picoleaf)

by rstierli · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
1931
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install nanoleaf
Description
Control Nanoleaf light panels via the Picoleaf CLI. Use for turning Nanoleaf on/off, adjusting brightness, setting colors (RGB/HSL), changing color temperature, or any Nanoleaf lighting control.
Usage Guidance
This skill appears to do exactly what it says: run the Picoleaf CLI to control local Nanoleaf lights. Before installing, verify which install method you will use: the registry lists a Homebrew formula (low risk), while the SKILL.md includes a curl|tar command that downloads a GitHub release and extracts into ~/.local/bin. If you use the binary install, inspect the release archive (checksum/signature if available) and the files it will place in your PATH. The skill instructs creating ~/.picoleafrc containing your local access_token — treat that file as sensitive (set restrictive file permissions). Ensure you trust the picoleaf distribution source and are comfortable that the agent can execute picoleaf commands on your local network (it can turn lights on/off and change settings).
Capability Analysis
Type: OpenClaw Skill Name: nanoleaf Version: 1.0.0 The skill is classified as suspicious due to its use of high-risk capabilities, specifically downloading and executing a remote binary via `curl -sL ... | tar xz -C ~/.local/bin` for installation, as detailed in `SKILL.md`. While this action is plausibly needed for the stated purpose of installing the `picoleaf` CLI, it introduces a supply chain risk by fetching and executing code from an external URL (https://github.com/tessro/picoleaf/releases/). Additionally, the skill instructs the agent to perform network requests for API token generation and to write a configuration file containing this access token, which are sensitive operations, though necessary for its function.
Capability Assessment
Purpose & Capability
Name/description, required binary (picoleaf), and runtime instructions all match: the skill wraps the Picoleaf CLI to control Nanoleaf lights. Requested binaries and config (~/.picoleafrc) are appropriate for this purpose.
Instruction Scope
SKILL.md stays on-scope: it instructs discovering the device on the local network, generating a local access token (requires physical button press), creating a local config file (~/.picoleafrc) with host and token, and running picoleaf commands. It does not request unrelated files, extra environment variables, or exfiltration to external endpoints.
Install Mechanism
Registry install spec lists a Homebrew formula (paulrosania/command-home/picoleaf) which is an expected low-risk mechanism. SKILL.md metadata also includes an alternative binary install that uses curl to download a GitHub release tarball and extract it to ~/.local/bin — GitHub Releases is a reasonable source but the SKILL.md and registry metadata are inconsistent. The tar+extract will write binaries to disk; verify the release source and contents before running.
Credentials
No environment variables or external credentials are requested. The skill requires storing a device-local access token in ~/.picoleafrc, which is appropriate and expected for controlling the device.
Persistence & Privilege
The skill does not request always:true, does not modify other skills, and has no elevated system persistence. Autonomous invocation is allowed (platform default) but not combined with any other elevated privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install nanoleaf
  3. After installation, invoke the skill by name or use /nanoleaf
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the Nanoleaf skill. - Control Nanoleaf light panels using the Picoleaf CLI. - Features include on/off, brightness adjustment, RGB/HSL color setting, and color temperature changes. - Provides setup instructions and usage examples for all major controls. - Supports installation via Homebrew or binary download.
Metadata
Slug nanoleaf
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Nanoleaf (Picoleaf)?

Control Nanoleaf light panels via the Picoleaf CLI. Use for turning Nanoleaf on/off, adjusting brightness, setting colors (RGB/HSL), changing color temperature, or any Nanoleaf lighting control. It is an AI Agent Skill for Claude Code / OpenClaw, with 1931 downloads so far.

How do I install Nanoleaf (Picoleaf)?

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

Is Nanoleaf (Picoleaf) free?

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

Which platforms does Nanoleaf (Picoleaf) support?

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

Who created Nanoleaf (Picoleaf)?

It is built and maintained by rstierli (@rstierli); the current version is v1.0.0.

💬 Comments