Agent skill

Byd Battery

by HybridAIOne in HybridAIOne/hybridclaw

Read BYD Battery-Box HVS/HVM/LVS/LVL home-storage telemetry through local Modbus or paired-inverter delegation, with read-only safety boundaries.

MITAuto-check passed

Install Byd Battery

skills CLI
$ npx skills add HybridAIOne/hybridclaw --skill byd-battery -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install HybridAIOne/hybridclaw byd-battery --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/HybridAIOne/hybridclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/byd-battery .claude/skills/byd-battery && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
byd-battery
GitHub stars
159
Token cost
~2.2k tokens
SKILL.md length
570 words
Files
2
Skills in repo
72
Repo updated
First seen
Licence
MIT

At a glance

Read BYD Battery-Box HVS/HVM/LVS/LVL home-storage telemetry through local Modbus or paired-inverter delegation, with read-only safety boundaries.

  • Works in 3 steps: Browser admin: open the active… → Browser /chat or TUI fallback → Local console fallback
  • SKILL.md covers Safety Boundary, Setup, Operation Rules and Register Boundary, plus 1 more section
  • Runs JavaScript scripts from its folder; calls node

What it does

Byd Battery is an agent skill from HybridAIOne/hybridclaw. Read BYD Battery-Box HVS/HVM/LVS/LVL home-storage telemetry through local Modbus or paired-inverter delegation, with read-only safety boundaries.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file.

The repository describes itself as: Enterprise-ready self-hosted AI assistant runtime with sandboxed execution, secure credentials, approvals, and memory. The licence is MIT.

Example prompts

  • “/byd-battery”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Browser admin: open the active HybridClaw admin URL ending in /admin/secrets and set the
  2. Browser /chat or TUI fallback
  3. Local console fallback

What it can do on your machine

Read from SKILL.md and the folder at commit 8162701. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com
    • bydbatterybox.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Byd Battery loads about 2.2k tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 570 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~39
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from HybridAIOne/hybridclaw at commit 8162701, republished under its MIT licence (© HybridAIOne). 570 words, ~2,159 tokens.

Download SKILL.mdSave it as .claude/skills/byd-battery/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
byd-battery
description
Read BYD Battery-Box HVS/HVM/LVS/LVL home-storage telemetry through local Modbus or paired-inverter delegation, with read-only safety boundaries.
user-invocable
true
requires.bins
node

BYD Battery

Use this skill for operator-approved monitoring of BYD Battery-Box Premium HVS, HVM, LVS, LVL, and older HV/LV family home-storage units. Prefer the bundled helper for all protocol details:

bash
node skills/byd-battery/byd-battery.cjs --format json read state-of-charge
node skills/byd-battery/byd-battery.cjs --format json read pack-telemetry
node skills/byd-battery/byd-battery.cjs --format json read cell-extremes
node skills/byd-battery/byd-battery.cjs --format json read inventory
node skills/byd-battery/byd-battery.cjs --format json read module-telemetry
node skills/byd-battery/byd-battery.cjs --format json read alarms
node skills/byd-battery/byd-battery.cjs --format json read firmware
node skills/byd-battery/byd-battery.cjs --format json read be-connect-metadata
node skills/byd-battery/byd-battery.cjs --format json read energy-counters
node skills/byd-battery/byd-battery.cjs --format json read state-of-charge --via fronius

Safety Boundary

Read-only v1. Do not attempt mutating actions through this skill. Remote shutdown, BMU reset, capacity reconfiguration, installer-app operations, cell-balancing overrides, write coils, and write-register requests are out of scope because they can affect a high-voltage DC battery. If a future v2 adds any mutating action, it must be red-stakes, require mandatory F8/F14 approval, and include installer handover instructions.

Never ask for, print, or store installer-app passwords such as common default installer codes in helper output. Treat them as SecretRef-managed even if they are well known.

Setup

Set local BMU connection values in this order:

  1. Browser admin: open the active HybridClaw admin URL ending in /admin/secrets and set the BYD_BMU_* values.
  2. Browser /chat or TUI fallback: /secret set BYD_BMU_HOST "192.168.1.50" plus the matching port, unit id, and model values.
  3. Local console fallback:
bash
hybridclaw secret set BYD_BMU_HOST "192.168.1.50"
hybridclaw secret set BYD_BMU_MODBUS_PORT "8080"
hybridclaw secret set BYD_BMU_UNIT_ID "1"
hybridclaw secret set BYD_BMU_MODEL "Premium HVS"

The helper uses the SecretRef names in metadata and output. It does not expose the configured LAN host, port, unit id, model, or any installer secret in normal results.

F3 host policy should allow only the BMU LAN host and Modbus port. BYD local Modbus does not require internet endpoints by default.

Operation Rules

  • Use read state-of-charge for current SoC, SoH, power direction, and summary incident hints.
  • Use read pack-telemetry for pack/output voltage, current, power, and pack temperature.
  • Use read cell-extremes for max/min cell voltage, voltage spread, and max/min temperature.
  • Use read inventory and read firmware for service handoff: serial, model family, tower/module topology, BMU/BMS firmware, hardware revision when present in the BMU block, inverter family, and grid mode.
  • Use read module-telemetry for per-module voltage and temperature summaries decoded from the read-only diagnostic 0x0558 pages. Larger systems may require multiple sampled pages; the helper reads only the allowlisted diagnostic holding-register range and never starts measurement with a write.
  • Use read be-connect-metadata for the read-only commissioning and firmware metadata that can be recovered from local BMU registers. It intentionally does not log in to Be Connect Plus or handle installer passwords.
  • Use read alarms to decode the alarm bitmap into human-readable codes and R29 incident-card payloads.
  • Use read energy-counters to emit shape-stable R5 charge/discharge kWh rollup fields.
  • If local Modbus is not configured but the battery is paired to Fronius, use --via fronius. The helper delegates to R21.111 Fronius local-power-flow / local-storage-realtime surfaces instead of inventing a BYD cloud path. This checkout does not currently bundle a Fronius helper path; treat the emitted delegation payload as a handoff to the R21.111 skill once that skill is present.
  • Stop after the first Modbus connect, timeout, exception, or comms-lost failure. The helper emits an R29 bmu-comms-lost incident-card payload; do not retry-loop against the BMU.
  • Be Connect Plus has no public API contract. For v1, use read be-connect-metadata, read firmware, and read inventory for read-only commissioning metadata available from local BMU registers; do not automate installer-app login or password flows.
Show full SKILL.md (69 more words)Show less

Register Boundary

The helper exposes only allowlisted read-holding-register ranges derived from the community BYD Battery-Box Premium Modbus maps:

  • 0x0000:0x0066 BMU identity, firmware, topology, inverter/grid mode.
  • 0x0500:0x0019 live SoC, SoH, pack voltage/current, alarms, energy counters.
  • 0x0010:0x0003 BMS parameter snapshot.
  • 0x0558:0x0041 tower/module diagnostic block.

No arbitrary register passthrough exists. No write function codes are exposed.

References

© HybridAIOne, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/byd-battery of HybridAIOne/hybridclaw.

  • SKILL.md
  • byd-battery.cjs

Open the folder on GitHubat commit 8162701

Compare with similar skills

Byd Battery next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Byd Battery compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Byd Battery this skillHybridAIOne/hybridclaw159—~2.2kAutomated safety check: PassMIT
Boxasgeirtj/system_prompts_leaks69k—~1.1kAutomated safety check: PassCC0-1.0
Entropy Boxsickn33/agentic-awesome-skills47k1 repos~5.4kAutomated safety check: WarnCC-BY-4.0
Suggestion Boxpaperclipai/paperclip100k—~1.3kAutomated safety check: PassMIT
Creating Box Plot InsightsPostHog/posthog40k—~1.1kAutomated safety check: PassCustom licence
Box Automationdavepoon/buildwithclaude3.6k7 repos~3.1kAutomated safety check: PassMIT

Similar skills

  • Box

    asgeirtj/system_prompts_leaks

    Search, read, upload, download, move, rename, delete, restore, and share Box content; manage comments and metadata.

    69k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Entropy Box

    sickn33/agentic-awesome-skills

    Entropy Box knowledge-compiler for embodied-AI: turns bounded requirements into grounded workflows via Solution Consult, Search, Lookup, and Evidence.

    47k GitHub starsUsed in 1 repo~5.4k tokens
    Auto-check: warnings
  • Suggestion Box

    paperclipai/paperclip

    Quietly suggest a concrete improvement after observing material, generalizable friction in agent work.

    100k GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Official

    Creates product analytics or SQL-backed box plot insights in PostHog.

    40k GitHub stars~1.1k tokensUpdated yesterday
    Data & AnalyticsAuto-check passed
  • Box Automation

    davepoon/buildwithclaude

    Automate Box cloud storage operations including file upload/download, search, folder management, sharing, collaborations, and metadata queries via Rube MCP (Composio).

    3.6k GitHub starsUsed in 7 repos~3.1k tokens
    Productivity & AutomationAuto-check passed
  • Darvas Box

    questflowai/investorskills

    A skill your agent uses when evaluating Nicolas Darvas-style box breakouts, new-high momentum, volume confirmation, and mechanical stop placement for liquid growth stocks.

    1.9k GitHub stars~569 tokensUpdated 1 mo ago
    Auto-check passed

More from HybridAIOne/hybridclaw

All 72 skills in this repo
  • Hermes3000 Writing

    HybridAIOne/hybridclaw

    Use Hermes3000 to plan, draft, revise, save, check consistency, and export long-form manuscripts through the Hermes3000 AI writing portal API.

    159 GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Manim Video

    HybridAIOne/hybridclaw

    Plan, script, render, and stitch Manim Community Edition videos in Python.

    159 GitHub stars~4.7k tokensUpdated today
    Auto-check: notes
  • Skill Creator

    HybridAIOne/hybridclaw

    Create and update SKILL.md-based skills with strong trigger metadata, lean docs, and reliable init, validate, package, and publish workflows.

    159 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • XLSX

    HybridAIOne/hybridclaw

    Create, edit, inspect, and analyze .xlsx spreadsheets and Excel workbooks.

    159 GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Excalidraw

    HybridAIOne/hybridclaw

    Create and revise editable .excalidraw diagrams as Excalidraw JSON for architecture diagrams, flowcharts, sequence diagrams, concept maps, and other hand-drawn explainers.

    159 GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Google Ads

    HybridAIOne/hybridclaw

    Manage Google Ads accounts with safe GAQL reporting, campaign planning, guarded mutations, and gateway-proxied REST API calls.

    159 GitHub stars~4k tokensUpdated today
    Auto-check passed

Questions about Byd Battery

What does Byd Battery do?

Read BYD Battery-Box HVS/HVM/LVS/LVL home-storage telemetry through local Modbus or paired-inverter delegation, with read-only safety boundaries. Byd Battery is an agent skill from HybridAIOne/hybridclaw. Read BYD Battery-Box HVS/HVM/LVS/LVL home-storage telemetry through local Modbus or paired-inverter delegation, with read-only safety boundaries.

How do I install Byd Battery in Claude Code?

Run `npx skills add HybridAIOne/hybridclaw --skill byd-battery -a claude-code`. Or copy the skill folder (skills/byd-battery in HybridAIOne/hybridclaw) into .claude/skills/byd-battery in your project. Claude Code loads it when a task matches its description.

How do I install Byd Battery in Codex?

Run `npx skills add HybridAIOne/hybridclaw --skill byd-battery -a codex`. Or copy the skill folder (skills/byd-battery in HybridAIOne/hybridclaw) into .agents/skills/byd-battery in your project. Codex loads it when a task matches its description.

Can I use Byd Battery in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add HybridAIOne/hybridclaw --skill byd-battery -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/byd-battery, .gemini/skills/byd-battery, .github/skills/byd-battery and .opencode/skills/byd-battery in your project.

What does Byd Battery need to run?

Going by SKILL.md and its folder, Byd Battery needs JavaScript for the scripts in its folder and the command-line tools its instructions call (node).

Does Byd Battery access the network?

SKILL.md names 2 domains. As links in the text: github.com and bydbatterybox.com. This is read from the text; nothing was executed.

Is Byd Battery safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Byd Battery use?

Byd Battery is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Byd Battery use?

About 2.2k tokens (SKILL.md is roughly 8.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Byd Battery?

Skills that share tags, products or a category with Byd Battery: Box (asgeirtj/system_prompts_leaks, 69k stars), Entropy Box (sickn33/agentic-awesome-skills, 47k stars), Suggestion Box (paperclipai/paperclip, 100k stars) and Creating Box Plot Insights (PostHog/posthog, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Byd Battery?

HybridAIOne (a GitHub organization) maintains it in HybridAIOne/hybridclaw, which has 159 GitHub stars. The repository holds 72 skills in this directory. The repository was last updated on October 9, 2026.

Source: HybridAIOne/hybridclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.