dojo-test

Automate Cairo tests for Dojo models and systems with assertions.

Updated Feb 16, 2026
One-click install
npx skills add https://github.com/steebchen/proof-of-war --skill dojo-test-steebchen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dojo-test
Source: https://github.com/steebchen/proof-of-war/tree/main/.agents/skills/dojo-test
Command: npx skills add https://github.com/steebchen/proof-of-war --skill dojo-test-steebchen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Dojo projects often require reliable tests that validate both models and higher-level systems. This skill provides a structured approach to generate and evolve Cairo-based tests using spawn_test_world, cheat codes, and rigorous assertions to ensure correctness and maintainability.

Core Features & Use Cases

  • Embeds unit tests inside model and system files to keep tests close to code
  • Supports integration-style tests with world-spawn setup and permissions
  • Includes cheat codes and state assertions to verify behavior across scenarios
  • Guides you from test scaffolding to running the test suite and validating results

Quick Start

Write tests for the spawn system and run the test suite to verify outcomes.

Frequently Asked Questions about dojo-test

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

FAQPage Schema
How do I generate tests for Dojo models and systems in Cairo?

To generate tests for Dojo models and systems, you use Cairo's test framework alongside Dojo utilities to automate test scaffolding, apply cheat codes, register models, and validate state through rigorous assertions.

What is the best way to structure integration tests for a Dojo world spawn?

The best way to structure integration tests for a Dojo world spawn involves using spawn_test_world to set up the environment, applying necessary permissions, and executing assertion-driven verifications across multiple scenarios.

Can I embed unit tests directly inside my Dojo model files?

Yes, you can embed unit tests directly inside Dojo model and system files to keep tests close to your code, ensuring reliable state validation and maintainability within your Cairo project.

How do Dojo cheat codes work when testing smart contract systems?

Dojo cheat codes work by allowing you to manipulate the test environment and state during system interactions, enabling rigorous assertions and reliable behavior verification across different test scenarios.

Do I need to manually register models when setting up Dojo tests?

No, you do not need to manually register models; the testing process coordinates model registrations automatically alongside test scaffolding and system interactions to ensure reliable state validation.