Agent skill

Testing Fundamentals

This skill covers testing ZX games for determinism and correctness. Use when the user asks about "sync testing", "replay testing", "determinism", "desync", "checksums", "test my game", or "verify determinism". **Load references when:** - Determinism patterns → `references/determinism-rules.md`

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/testing-fundamentals-nethercore-systems-nethercore-ai-plugin

SKILL.md

Testing Fundamentals for Nethercore ZX

Sync Testing

Runs two identical instances, compares checksums each frame.

bash
nether run --sync-test
nether run --sync-test --frames 3000  # Specific duration

Pass criteria: Identical checksums for 1000+ frames.

Replay Testing

Record and replay for regression testing:

bash
nether run --record replay.bin  # Record
nether run --replay replay.bin  # Playback

Workflow:

  1. Record on known-good build
  2. Replay on new build
  3. Compare outcomes

Determinism Rules

Do Don't
zx::random() rand::thread_rng()
BTreeMap, BTreeSet HashMap, HashSet
Frame counter Instant::now()
Fixed-point math Floating-point accumulation

Test Organization

Type Tool Purpose
Unit cargo test Pure logic
Sync nether run --sync-test Runtime determinism
Replay --record/--replay Cross-build validation

Common Desync Causes

  • Non-deterministic RNG
  • HashMap iteration order
  • System time reads
  • Uninitialized memory

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results