---

name: test description: Run the test suite by building tests and deploying to Nintendo Switch. Use for running tests, verifying changes on hardware, or validating implementations. allowed-tools: Bash(just --list:), Bash(just build-tests:), Bash(just list-options-configured:), Bash(just reconfigure:)

Test Skill

This skill orchestrates the full test workflow for the nx-std project. Tests run on actual Nintendo Switch hardware.

When to Use This Skill

Use this skill when you need to:

• Validate code changes on real hardware
• Run the test suite after implementing features
• Verify FFI correctness between Rust and C code
• Confirm changes before creating a PR

Workflow

This skill orchestrates the full test workflow by invoking other skills:

Step 1: Build Tests

Use the /build skill to build the test NRO:

Copyjust build-tests

This compiles the test suite into buildDir/subprojects/tests/nx-tests.nro.

Step 2: Deploy to Switch

Use the /deploy skill to deploy the test NRO to the Nintendo Switch:

Copyjust deploy buildDir/subprojects/tests/nx-tests.nro

The deploy skill handles network transfer to the Switch via cargo-nx.

Step 3: Verify Results

🚨 MANDATORY: Ask the user to confirm the tests passed on the console.

Do NOT assume tests passed. The test output is only visible on the Switch screen.

Automatic Orchestration

When you invoke /test, you should:

1. Verify use_nx=enabled prerequisite is met (reconfigure if needed)
2. Invoke /build skill with just build-tests
3. Invoke /deploy skill with the built NRO path
4. Ask the user to confirm test results

This ensures tests properly validate the Rust implementations.

Test Architecture

Tests are C code that link against Rust crates to verify FFI correctness. Located in subprojects/tests/:

• source/main.c - Test harness entry point
• source/harness.h - Test framework macros
• source/sync/ - Synchronization primitive tests
• source/rand/ - Random number generation tests

Prerequisites

Build Configuration:

• Tests MUST be built with use_nx=enabled (unless user explicitly requests otherwise)
• Check with: just list-options-configured | grep use_nx
• Reconfigure if needed: just reconfigure -Duse_nx=enabled

Hardware/Deployment (see /deploy skill for details):

• Nintendo Switch setup requirements
• Network connectivity requirements
• cargo-nx installation

Related Skills

• /build - Building targets (including just build-tests)
• /deploy - Deploying to Switch hardware
• /format - Formatting code before testing