haroldo-ok

Xquest2 Md — Development skill for Claude Code

Development community

A W.I.P. vibe-port experiment converting Mark Mackey's XQuest 2 from MS-DOS to Sega Genesis / Megadrive, using Claude.

How to install Xquest2 Md

This entry records only its repository, not the path inside it, so there is no exact command to give. Open haroldo-ok/xquest2-md and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Xquest2 Md does

A W.I.P. vibe-port experiment converting Mark Mackey's XQuest 2 from MS-DOS to Sega Genesis / Megadrive, using Claude.

Alternatives in Development

Epic Review — Mark epic review requested, approved, or changes requested 243.5k ★
Experiment — Experiment — Setup + Code Generation + Execution 613 ★
Detailed Planning Agent — You are an expert detailed planning agent specializing in converting coarse implementation tasks into step-by 129 ★

README

XQuest 2 → Sega Genesis Port

SGDK 1.70 Project Scaffold

Original game by Mark Mackey (1996, MS-DOS) Genesis port scaffold generated from full binary asset extraction

Project Structure

xquest2_sgdk/
├── Makefile
├── README.md
├── inc/
│   └── xquest.h          ← All types, constants, function prototypes
├── src/
│   ├── main.c            ← Entry point, game loop, VBlank
│   ├── player.c          ← Ship movement, firing, smartbomb, death
│   ├── enemy.c           ← All 15 enemy AI behaviours
│   └── game.c            ← collision, level gen, gem, bullet, mine,
│                            smartbomb, hud, title, sfx (scaffold)
└── res/
    ├── resources.res     ← SGDK resource declarations
    ├── palettes/         ← 4× Genesis 16-color palette PNGs
    ├── sprites/          ← 125 Genesis-remapped 16×16 sprite PNGs
    ├── screens/          ← Title screen PNG (320×240 → crop to 320×224)
    └── sounds/           ← 9 WAV files (8000 Hz, 8-bit unsigned PCM)

Build Requirements

Tool	Version	Notes
SGDK	1.70	Set `export SGDK=/opt/sgdk`
Java	11+	For `rescomp.jar`
m68k-elf-gcc	6.3+	Motorola 68000 cross-compiler
BlastEm	any	Recommended emulator for testing

# Build
make

# Build + run in BlastEm
make run

# Clean
make clean

Asset Summary

Sprites (125 total, 16×16 px)

All sprites extracted from `XQUEST.GFX` and remapped to 4 Genesis palettes.

Category	Count	Palette	Key sprites
Background tiles	34	PAL0	Wall (8), Floor (18), Cyan floor (4), Edge (4)
Player ship	8	PAL1	2 body frames, 3 thrust, 2 diagonal, 1 dir
Mine	5	PAL1	5-frame animation
Bullets	5	PAL1/3	Player (red), enemy green, enemy yellow
Gems	4	PAL2	1 base + 3 sparkle animation frames
Exit gate	9	PAL2	9-frame open animation
PowerCharge	1	PAL2	Pickup item
SmartBomb fx	2	PAL3	Screen-clear effect
Ex