wb-plc

wb-ai-skills

English · Русский

Two things in one repository, both built to help AI coding agents work with a Wiren Board controller:

1. wb-plc plugin — methodology skills for AI agents that drive a controller over SSH. Distributed as a Claude Code / GitHub Copilot CLI plugin and as plain markdown for any other agent. See Skills below.
2. wb-cli package — Debian package installed on the controller. CLI with a stable JSON envelope contract, built so an agent can SSH in and call wb-cli --json <command> to get structured output. See wb-cli below.

The two are independent: you can use the skills without the controller package, and vice versa.

---

Skills

The wb-plc/skills/ directory holds nine skills covering everything a remote agent needs to operate a WB controller: discovery, troubleshooting, network, MQTT, Modbus, automation rules, Zigbee, backup/restore, and writing custom software for the controller.

Skill	What it covers
wiren-board	Master entry: mDNS discovery, SSH conventions, wb-cli usage. Load first.
wb-troubleshooting	Failed systemd units, disk, kernel/firmware mismatch, Docker, diagnostic archive.
wb-serial	RS-485 / Modbus — custom templates, device configuration, bus diagnostics (CRC, timeouts).
wb-rules	wb-rules JavaScript automation (ES5, virtual devices, cron, sensors).
wb-mqtt-broker	Mosquitto MQTT broker — auth, ACLs, TLS, external bridges.
wb-network	Ethernet, WiFi, 4G, OpenVPN, failover, DNS, hotspot.
wb-zigbee	Zigbee via zigbee2mqtt (pairing, OTA, native vs Docker).
wb-controller-backup	Full controller backup and restore.
wb-dev	Writing software for WB — daemons, MQTT bridges, MQTT-RPC, cross-compilation, Debian packaging.

Install for Claude Code or GitHub Copilot CLI (recommended)

Both agents read the same plugin manifest. One command to register the marketplace, one to install the plugin:

/plugin marketplace add wirenboard/wb-ai-skills
/plugin install wb-plc@wb-ai-skills

Updates: /plugin marketplace update wb-ai-skills then /plugin update wb-plc@wb-ai-skills.

Install for OpenCode, older Claude Code, or other agents

Use install-skills.sh — it materializes the skills into the format each agent expects.

# Claude Code (skill format — directory with SKILL.md + side files)
./install-skills.sh claude              # → ./.claude/skills/   (project-local)
./install-skills.sh claude --global     # → ~/.claude/skills/   (user-wide)

# OpenCode (flat .md per agent, frontmatter rewritten: allowed-tools → mode: primary)
./install-skills.sh opencode            # → ./.opencode/agents/
./install-skills.sh opencode --global   # → ~/.config/opencode/agents/

# Any other agent (frontmatter trimmed to name + description)
./install-skills.sh manual --dest /path/to/agent/prompts

# Uninstall
./install-skills.sh uninstall claude --global

./install-skills.sh --help lists all flags and defaults.

Install on Windows

PowerShell — copy the skill directories from wb-plc/skills/ to the agent's skills folder.

Agent	Destination
Claude Code (user-wide)	%USERPROFILE%\.claude\skills\
Claude Code (project)	.claude\skills\ inside the project
OpenCode (user-wide)	%APPDATA%\opencode\agents\ (flatten — extract SKILL.md as <name>.md, rewrite allowed-tools: to mode: primary)

Install on the controller

The wb-cli .deb also drops the skill markdowns into /usr/share/wb-cli/skills/ so an agent that SSH'd in can read them locally.

---

wb-cli

Command-line tool that runs on the controller, exposing controller state and operations through a stable JSON contract.

ssh root@wirenboard-A25NDEMJ wb-cli info
# serial_number   A25NDEMJ
# release_name    wb-2602
# hostname        wirenboard-A25NDEMJ
# uptime_seconds  407130.59

ssh root@wirenboard-A25NDEMJ wb-cli --json info
# → {"data": {"serial_number": "A25NDEMJ", "release_name": "wb-2602", ...}}

ssh root@wirenboard-A25NDEMJ wb-cli --json dev wb-mr6c_2/K1 1
# → {"data": {"device": "wb-mr6c_2", "control": "K1", "value": "1", "ok": true}}

Commands