sega-32x-gamedev

An agent skill by haroldo-ok, from haroldo-ok/sega-32x-skill-for-claude. Tags: build-tool, debugging, development, hardware, migration, optimization.

What it does

Create, improve, optimize, and port games for the Sega 32X (Sega Mars) using Chilly Willy's 32XDK toolchain and the DOOM 32X Resurrection (d32xr) codebase as reference. Use whenever the user wants to port a game (DOS, Genesis, PICO-8, HTML5, or any platform) to the 32X, build or debug a homebrew 32X ROM, or make a 32X game of any kind: software-3D / polygon (fixed-point transform, flat-triangle rasterizer), a Comanche-style voxel landscape / voxel shmup, or a 2D sprite game / shooter / arcade port with menus. Also for the second SH-2 / dual-core, optimizing SH-2 code, measuring framerate, fixing a black-screen ROM, or PicoDrive tests. Trigger even when the user only says "port X to 32X", "make a 32X game", "3D/voxel on 32X", "compile this for 32X", mentions a `.32x` ROM, SH-2 / dual-SH2 / 68000 Mars hardware, the mars.ld linker, VDP framebuffer/palette issues, or PWM audio. Prefer this skill over general knowledge for the 32X: its toolchain, memory map, and test methodology are easy to get subtly wrong.

Install

With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:

npx skills add haroldo-ok/sega-32x-skill-for-claude --skill sega-32x-gamedev

Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):

git clone --depth 1 https://github.com/haroldo-ok/sega-32x-skill-for-claude
cp -r sega-32x-skill-for-claude/skills/sega-32x-gamedev ~/.claude/skills/sega-32x-gamedev

Safety box score

Grade C, moderate risk: 44 of 100 risk points, rated 2026-10-03. The grade rates what the skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. How the score works.

This skill is a build-and-test workflow for Sega 32X homebrew: it compiles local code, installs a cross-toolchain, and runs an emulator harness that executes the ROM under a libretro core. The main risks are a privileged system-wide toolchain install, network downloads from GitHub, and destructive local cleanup of build/output directories.

Category levels, from 0 (none) to 3 (high)
Category	Level	Why
Code & shell execution	2 (moderate)	The skill runs local build and test programs via `make`, `python3 tests/run_tests.py`, and `harness.c` (`dlopen(core_path, RTLD_NOW)`), so it does execute code, but only from local files and not from fetched remote scripts.
Network access	2 (moderate)	It explicitly downloads the toolchain archive with `curl -LO https://github.com/viciious/32XDK/releases/download/20220418/...tar.zst` and mentions `apt-get` setup for dependencies.
Filesystem reach	2 (moderate)	It writes build products under `build/` and `rom/`, and the clean target does `rm -rf $(BUILD) rom`, which is destructive even though it is scoped to project outputs by default.
Secrets & credentials	0 (none)	No file reads or commands touch tokens, passwords, `.env` files, keychains, browser sessions, or pasted secrets.
Privilege & persistence	3 (high)	Installation instructions use `sudo tar --zstd -xf ... -C /` and `sudo apt-get install -y ...`, which require root and modify system locations like `/opt/toolchains/sega`.
Instruction hijack surface	0 (none)	The files contain workflow guidance and build/test steps, but nothing that tells the agent to ignore its rules, hide actions, or follow untrusted remote instructions.
Irreversible actions	1 (low)	It automates ROM builds and scripted emulator runs, but it does not deploy, post, pay, book, or otherwise act outside the local machine.
Transparency	1 (low)	`references/testing.md` could not be read (`not read: size or budget`), so part of the testing/debugging guidance is opaque to review.

Before installing

Read `SKILL.md` and `assets/Makefile`; confirm you accept the `sudo` toolchain install and the `rm -rf $(BUILD) rom` clean step.
Verify the GitHub release URL and, if possible, add a checksum check for the 32XDK tarball before running it as root.
Run `tests/run_tests.py` only with a trusted local PicoDrive core in a scratch checkout first.
Open `references/testing.md` manually, since it was not readable in this review.

Rated 2026-10-03 by an automated review of 25 files from the skill's repository.

Source

Repository: haroldo-ok/sega-32x-skill-for-claude (all skills from this repository)
Path: skills/sega-32x-gamedev/SKILL.md
Branch: main
Updated: 2026-09-23

migrate-birp-to-urp — Plans, executes, and troubleshoots Unity projects moving from the Built-in Render Pipeline (BiRP/BIRP/Built-in RP) to the Universal Render Pipeline (URP).
sega-master-system-devkitsms — Program, build, debug, and port Sega Master System (and Game Gear / SG-1000) homebrew games in C with devkitSMS (SMSlib + PSGlib) and the SDCC Z80 compiler.
app-platform-migration — Migrate applications from Heroku, AWS, Render, Railway, Fly.io, or Docker Compose to DigitalOcean App Platform. Use when converting existing apps.
expo-dom — Framework (OSS). Use Expo DOM components to run web code in a webview on native and as-is on web. Migrate web code to native incrementally.
expo-migrate-module — Framework (OSS). Migrate an existing Apple/Swift Expo native module from the Expo Modules API 1.0 definition DSL to the 2.0 macro API (sometimes called v2).
expo-upgrade — Framework (OSS). Guidelines for upgrading Expo SDK versions and fixing dependency issues