| name | write-dotnet-code |
| description | Write and review C#/.NET code in Dynamo following Dynamo coding standards, modern C# patterns, and repo conventions. Use this skill whenever writing C# code, reviewing a PR diff, designing types, managing PublicAPI surface files, choosing patterns, making performance decisions, or refactoring in the Dynamo codebase. Also use when asking about NUnit testing, async patterns, error handling, immutability, or security in Dynamo. |
Dynamo dotNET Expert
When to use
- Writing or reviewing C#/.NET code in Dynamo.
- Designing public APIs, choosing types, or making performance decisions.
- Managing PublicAPI surface files.
- Refactoring for modern C# patterns.
- WPF/UI work in
DynamoCoreWpf.
When not to use
- Writing NUnit tests -- use the repo-specific
dynamo-unit-testing skill instead.
- Architecture / onboarding questions -- use the repo-specific
dynamo-onboarding skill instead.
- PR descriptions -- use the
generate-pr-description skill instead.
Inputs expected
A C# file or diff to review, a feature requirement, or a question about .NET patterns in the Dynamo codebase.
Output format
Code suggestions with explanations, or a review with specific file/line references.
Workflow
- Read before suggesting — read the relevant file(s) before proposing changes.
- Repo conventions win — when repo standards conflict with generic .NET advice, follow the repo.
- Check public API impact — any new public member needs a
PublicAPI.Unshipped.txt entry.
- Run quality checks — before finishing, verify against references/quality-checklist.md.
Quick Decision Guide
| Situation | Action |
|---|
| Adding a public member | Update PublicAPI.Unshipped.txt — see PublicAPI guide in the Dynamo repo |
| DTO / immutable data | Use record |
| Small value type (< 16 bytes) | Use readonly record struct |
| Class not designed for inheritance | Mark sealed |
| Async in library code | Add ConfigureAwait(false) |
| User-facing string | Put it in a .resx file |
| New node | Add .dyn, .md, .jpg to doc/distrib/NodeHelpFiles/ |
| Breaking public API change | File a GitHub issue first |
Project Conventions
Naming
- PascalCase for public members, classes, methods.
- camelCase for private fields and local variables.
- Prefix private fields with underscore only if the file already does so consistently.
- XML documentation required on all public methods and properties.
Comments
Comments explain why, not what.
Tech Stack
| Dynamo |
|---|
| TFM | net10.0 (full UI: win-x64 only) |
| Test framework | NUnit |
| Build (full) | msbuild src/Dynamo.All.sln |
| Build (core) | dotnet build src/DynamoCore.sln |
| IDE | Visual Studio 2022 |
Assets & References
- references/quality-checklist.md — Anti-patterns, security rules, file constraints, PR checklist
- assets/csharp-patterns.md — Modern C#, type design, async, immutability, performance, WPF/UI, examples (lives in the Dynamo repo)
- assets/publicapi-guide.md — PublicAPI.Unshipped.txt workflow, breaking changes, extend-only design (lives in the Dynamo repo)
Related Skills:
clean-dotnet-code • generate-pr-description
