Dynamo Unit Testing
Testing & Qualitydynamo-unit-testingDynamo Unit Testing is an Agent Skill for testing & quality published in the DynamoDS/Dynamo repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Write comprehensive NUnit tests for the Dynamo codebase following Dynamo testing patterns, conventions, and architectural constraints. Use this skill when writing test methods, test classes, setting up test infrastructure, mocking dependencies, testing with .dyn files, or reviewing test code in Dynamo.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/DynamoDS/Dynamo/blob/HEAD/.claude/skills/dynamo-unit-testing/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/dynamo-unit-testing, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Dynamo Unit Testing
When to use
- Writing new test methods or test classes for Dynamo components
- Setting up test infrastructure (base classes, setup/teardown)
- Testing nodes, workspaces, or UI components
- Working with .dyn test files or sample graphs
- Reviewing existing tests for quality and patterns
- Debugging test failures or flaky tests
When not to use
- General coding questions -- use dynamo-dotnet-expert instead
- Architecture questions -- use dynamo-onboarding instead
- PR descriptions -- use dynamo-pr-description instead
Inputs expected
Test requirements, failing functionality to test, existing code to cover, or test code to review.
Output format
Complete test classes with proper setup, test methods using Dynamo patterns, and explanations of testing approach.
Workflow
🚀 Quick Start: test-patterns.md has ready-to-use templates
1. Choose Your Base Class
Select the appropriate test base class based on what you're testing:
- UnitTestBase - Utilities, algorithms, no Dynamo model needed
- DynamoModelTestBase - Nodes, workspaces, commands (most common)
- DSEvaluationUnitTestBase - DesignScript expression evaluation
2. Apply Testing Standards
3. Write Focused Tests
One behavior per test, descriptive names, Arrange-Act-Assert structure.
Testing Principles
- NUnit only - Use NUnit framework exclusively (never xUnit/MSTest)
- One behavior per test - Each test validates exactly one scenario
- Pragmatic .dyn testing - .dyn file tests allowed in unit categories for focused functionality
Documentation
Assets & References:
- test-patterns.md - Base classes, code templates, common scenarios, complete examples
- quality-checklist.md - Quality guidelines, anti-patterns, best practices
Related Skills:
- dynamo-dotnet-expert
- dynamo-onboarding