des-usage

Run and assert headless DES JSON game scenarios with seeded RNG.

Updated Dec 13, 2025
One-click install
npx skills add https://github.com/EliasVahlberg/saltglass-steppe --skill des-usage
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: des-usage
Source: https://github.com/EliasVahlberg/saltglass-steppe/tree/main/.kiro_snapshot_2026-04-04_1209/skills/des-usage
Command: npx skills add https://github.com/EliasVahlberg/saltglass-steppe --skill des-usage

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a clear, structured way to write and run headless DES (Debug Execution System) scenarios so developers can validate game mechanics, reproduce bugs, and catch regressions without manual playtesting.

Core Features & Use Cases

  • Deterministic Execution: Use seeded RNG to reproduce outcomes reliably across runs.
  • Rich Action & Assertion Language: Schedule player and entity actions, apply mocks, and assert player, enemy, map, quest, and status conditions.
  • Inheritance & Mocks: Base scenario inheritance and mock settings let you compose common setups and force deterministic behaviors for focused tests.
  • Use Case: Validate movement, combat resolution, inventory interactions, quest progression, and environmental effects in automated CI or developer testing.

Quick Start

Run the DES scenario tests/scenarios/basic_movement.json with a fixed seed to verify player movement and assertions succeed.

Frequently Asked Questions about des-usage

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

FAQPage Schema
How do I automate headless game testing for deterministic mechanics in Rust?

Automate headless game testing by defining scenarios as DES JSON files, applying seeded RNG for reproducibility, and asserting mechanics like movement or combat. This validates core gameplay logic without manual playtesting.

What is DES JSON scenario inheritance and how does it work for game tests?

DES scenario inheritance allows you to compose common test setups using base scenarios. You define foundational states once and reuse them across multiple test cases, applying mock settings to force deterministic behaviors for focused testing.

Can I mock game systems and schedule player actions in a deterministic test environment?

Yes, you can mock game systems and schedule player or entity actions within DES scenarios. This allows you to force specific deterministic behaviors and validate mechanics like inventory, quests, and environmental effects reliably.

How do I run and assert headless scenarios to catch game regressions?

Run headless scenarios by executing DES JSON files with a fixed seed, then use the assertion language to validate player, enemy, map, and quest states. This reliably catches gameplay regressions across automated runs.

Does deterministic game testing work for validating combat and quest progression?

Deterministic game testing works for validating combat resolution, quest progression, inventory interactions, and environmental effects. It uses seeded RNG to ensure outcomes remain reproducible across multiple test executions.