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`
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.
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:
nether run --record replay.bin # Record
nether run --replay replay.bin # Playback
Workflow:
- Record on known-good build
- Replay on new build
- 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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?