Wb Ai Skills

wb-ai-skills

[](https://github.com/wirenboard/wb-ai-skills/actions/workflows/ci.yml)

*English · [Русский](README.ru.md)*

Two things in one repository, both built to help AI coding agents work with a [Wiren Board](https://wirenboard.com) 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 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 eleven skills covering everything a remote agent needs to operate a WB controller: discovery, troubleshooting, root-cause investigation, network, MQTT, Modbus, MOD slots, 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-rca	Root-cause investigation of field problems & regressions — reproduce, ground claims, A/B versions, prove, file a bug report.
wb-serial	RS-485 / Modbus — custom templates, device configuration, bus diagnostics (CRC, timeouts).
wb-mod-slots	Reconfigure WB MOD slots (UART / I2C / CAN / SPI / 1-Wire) via wb-hwconf-helper and device-tree overlays.
wb-rules	wb-rules JavaScript automation (ES5, virtual devices, cron, sensors).
wb-mqtt-broker	Mosquitto MQTT broker — auth, ACLs, TLS, external bridges.