s3k-zone-validate

Compare reference and engine screenshots to validate Sonic 3 & Knuckles zone features.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you confirm whether a Sonic 3 & Knuckles zone feature is implemented correctly by comparing the game engine against stable-retro reference captures.

Core Features & Use Cases

  • Parallax verification: Check background layer count, scroll rates, water splits, and seam artifacts.
  • Palette cycling validation: Confirm time-based color changes for water, lava, lights, and other animated palettes.
  • Animated tile and event checks: Review waterfalls, conveyors, camera locks, boss arenas, and act transitions using both visual comparison and headless tests.
  • Use case: A contributor can validate Hydrocity Zone or Launch Base Zone after a rendering change and produce a clear PASS, LIKELY, FAIL, or SKIP report.

Quick Start

Use the s3k-zone-validate skill to validate a chosen zone and act, compare reference and engine screenshots, and generate a concise validation report.

Frequently Asked Questions about s3k-zone-validate

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

FAQPage Schema
How do I validate Sonic 3 & Knuckles zone features after a rendering change?

To validate Sonic 3 & Knuckles zone features, you can compare engine screenshots against stable-retro reference captures. This process checks parallax layers, palette cycling, and animated tiles to generate a concise validation report.

How does visual comparison work for S3K parallax and palette cycling verification?

Visual comparison for S3K parallax and palette cycling verification works by applying image-recognition to compare engine screenshots with reference captures. This detects background scroll rates, water splits, and time-based color changes for water or lava.

Can I use headless testing for deterministic behavior in S3K act-transition testing?

Yes, you can use optional headless testing for deterministic behavior in S3K act-transition testing. It complements visual comparison by validating specific events like camera locks, boss arenas, and animated tiles.

What is the best way to check animated tiles and camera events in a Sonic 3 & Knuckles zone?

The best way to check animated tiles and camera events in a Sonic 3 & Knuckles zone is by using visual comparison and headless tests. This combination verifies waterfalls, conveyors, and camera locks against stable-retro captures.

Does zone validation support reporting for Hydrocity or Launch Base Zone implementations?

Yes, zone validation supports reporting for Hydrocity or Launch Base Zone implementations. After comparing screenshots, the skill produces a clear PASS, LIKELY, FAIL, or SKIP report to confirm if the feature is implemented correctly.