iCUE Widget Builder Skill

An AI-agent skill for building, reviewing, and packaging CORSAIR iCUE widgets.

This repository packages one universal iCUE widget-building skill that can be copied into Claude Code, Codex, OpenCode, or another compatible skill directory. The skill includes the workflow, technical documentation, examples, and reference checklists needed to create widgets for supported CORSAIR device screens such as Xeneon Edge, Pump LCD (all round screens, iCUE LINK TITAN II 360 RX LCD / 5" Module, NAUTILUS II RS LCD / iCUE LINK TITAN II ULTRA 360 LX LCD), and keyboard LCD displays.

What this skill helps with

Use the iCUE Widget Builder skill when you want an AI coding agent to:

• create a new iCUE HTML widget from a user idea or product requirement;
• modify or debug an existing widget;
• choose the correct widget layout for a target device screen;
• use iCUE plugins such as sensors, media, link, FPS, device action, file system, notifications, and Stream Deck providers;
• declare and manage widget permissions in manifest.json (network hosts, local files/folders, hardware, clipboard, external applications such as Stream Deck) with least-privilege scoping and graceful handling of denied or revoked access;
• add settings controls, translations, lifecycle handling, and local storage;
• validate widget behavior against the bundled security and testing checklists;
• package the final widget for iCUE installation.

Requirements

To build and package widgets successfully, install the following:

• iCUE 5.52 or later — the bundled documentation targets Widget API 1.9.0 / iCUE 5.52 (manifest permissions, File System and Notifications providers, Stream Deck Provider 1.2, Media Provider 1.1). Widgets that avoid these features may run on older iCUE versions; verify against the docs before lowering min_app_version.
• iCUE Widget CLI — required to validate and package widgets into .icuewidget files for installation or distribution.
• A compatible CORSAIR device — recommended for final device testing.

Download iCUE from the official CORSAIR downloads page: .

The iCUE Widget CLI is distributed through npm (icuewidget-cli). It requires Node.js. Install it globally:

npm install -g icuewidget-cli

To update it later, run npm install -g icuewidget-cli@latest.

After installing the CLI, verify it is available in your terminal:

icuewidget --version