nintendo-dev-skills

Agent skills for Nintendo Wii / GameCube homebrew development, usable both as a Claude Code plugin and via skills.sh.

Skills

Skill	What it does
console-test-rig	Orchestrator — turns "test my app on the console" into a deploy → drive → capture → read-logs workflow using the skills below.
wiiload-deploy	Deploy a homebrew .dol/.elf build to a console over the network with wiiload.
gamecube-controller	Simulate a GameCube controller from the computer via a u1f992/jiangtun RP2040 device.
console-capture	Capture a console's HDMI output via a USB capture card for visual feedback.
usbgecko	Read console serial/debug logs over a USB Gecko (FTDI) adapter.

Give a high-level request like "test my app on the console" and console-test-rig decomposes it across the focused skills; use the focused skills directly for single actions.

Install

skills.sh (npx)

Install the skills as plain Agent Skills — no Claude Code plugin system needed:

npx skills add webhdx/nintendo-dev-skills          # all skills
npx skills add gamecube-controller                 # a single skill by slug

The repo follows the skills.sh layout (skills/<slug>/SKILL.md + skills.sh.json for grouping), so it also lists directly on skills.sh. This path has no install wizard — configure with environment variables (see Configuration).

Claude Code (plugin)

Inside Claude Code:

/plugin marketplace add webhdx/nintendo-dev-skills
/plugin install nintendo-dev-skills@webhdx

…or from the terminal:

claude plugin marketplace add webhdx/nintendo-dev-skills
claude plugin install nintendo-dev-skills@webhdx

Installs all five skills (they trigger automatically by task) and prompts for the hardware settings via the install wizard (see Configuration). Update later with /plugin update nintendo-dev-skills@webhdx.

Layout

.claude-plugin/
├── plugin.json           Claude Code plugin manifest (this repo is one plugin)
└── marketplace.json      Claude Code marketplace catalog
skills/
├── console-test-rig/      orchestrator (no scripts; routes to the others)
├── wiiload-deploy/        SKILL.md + scripts/wiiload_send.sh
├── gamecube-controller/   SKILL.md + scripts/gc_input.py
├── console-capture/       SKILL.md + scripts/gc_capture.sh
└── usbgecko/              SKILL.md + scripts/gecko_log.py
skills.sh.json            skills.sh grouping/customization
LICENSE                   GPL-3.0

Configuration

When you install the plugin, Claude Code prompts for the hardware settings via its configuration dialog (the jiangtun port, USB Gecko port, HDMI capture index, and console IP) — fill them in once and the skills pick them up. All fields are optional; leave a port blank to autodetect.

For local use (--plugin-dir) or to override, the same values are read from environment variables: GC_INPUT_PORT, GECKO_PORT, GC_CAPTURE_INDEX, CONSOLE_IP.

License

GPL-3.0-or-later. The jiangtun firmware is a separate project you flash yourself; these skills only ship host-side scripts and docs.