s1-retro-trace

Record Sonic 1 physics traces for Java replay verification.

6|1|Updated Jan 16, 2013
One-click install
npx skills add https://github.com/OpenGGF/OpenGGF --skill s1-retro-trace
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: s1-retro-trace
Source: https://github.com/OpenGGF/OpenGGF/tree/main/.agents/skills/s1-retro-trace
Command: npx skills add https://github.com/OpenGGF/OpenGGF --skill s1-retro-trace

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you record and validate Sonic 1 physics traces for trace replay testing, replacing manual setup with a repeatable recording workflow.

Core Features & Use Cases

  • Records full-run traces from stable-retro movies or savestates for zones like GHZ1 and MZ1.
  • Captures credits demo traces directly from the ROM without external input.
  • Verifies trace outputs and prepares the files expected by Java replay tests, supporting cross-checking against BizHawk recordings.

Quick Start

Ask this skill to record the Sonic 1 trace you need, then copy the generated physics, auxiliary state, and metadata files into the matching test resource folder.

Frequently Asked Questions about s1-retro-trace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I record Sonic 1 physics traces for replay verification?

Record Sonic 1 physics traces by capturing full-run movies or savestate boots from stable-retro. The process generates physics.csv, aux_state.jsonl, and metadata.json files formatted specifically for Java trace replay test suites.

What is a physics trace replay test for Sonic 1?

Physics trace replay testing validates game behavior by recording movement data and cross-checking it against expected outputs. This Skill captures the necessary physics.csv and aux_state.jsonl files to automate verification for zones like GHZ1 and MZ1.

Can I use BizHawk BK2 inputs to generate Sonic 1 physics traces?

Yes, the Skill supports BizHawk BK2 inputs for Sonic 1 trace replay tests. It cross-checks recorded physics traces against BizHawk recordings to ensure accurate physics.csv and metadata.json generation for the test suite.

How do I capture Sonic 1 credits demo traces directly from the ROM?

Capture Sonic 1 credits demo traces directly from the ROM without external input. The Skill handles the credits demo workflow automatically, producing the required physics.csv and aux_state.jsonl files for replay verification.

What files do I need for the Java Sonic 1 trace replay test suite?

The Java trace replay test suite requires physics.csv, aux_state.jsonl, and metadata.json. This Skill produces these exact output files from stable-retro or BizHawk recordings for direct placement into test resource folders.