Csharp Guidelines
Developmentcsharp-guidelinesCsharp Guidelines is an Agent Skill for development published in the dennisdoomen/CSharpGuidelines repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Apply the C# coding and design guidelines by Dennis Doomen when writing, reviewing, or refactoring C# code. Use this skill whenever you generate or evaluate C# to ensure it follows the established rules for class design, member design, maintainability, naming, performance, testability, and more.
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/dennisdoomen/CSharpGuidelines/blob/HEAD/Skills/csharp-guidelines/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/csharp-guidelines, 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.
C# Coding Guidelines
Apply these rules whenever writing or reviewing C# code.
Severity: Must = always enforce · Should = follow unless there is a clear reason not to · May = optional good practice.
Consult the references/ files for the full set of rules per category:
- General (AV0100) — KISS, YAGNI, DRY, OOP pillars, AI code
- Class Design (AV1000) — SRP, LSP, LoD, coupling
- Member Design (AV1100) — properties, methods, parameters, null rules
- Miscellaneous Design (AV1200) — exceptions, events, generics, LINQ
- Maintainability (AV1500) — method size, var, control flow, naming files
- Testability (AV1600) — test naming, builders, public API testing
- Naming (AV1700) — casing, prefixes, abbreviations, async suffix
- Performance (AV1800) — async/await, Task, ValueTask
- Framework Usage (AV2200) — idiomatic C#, dynamic, LINQ syntax
- Documentation (AV2300) — XML docs, inline comments
- Layout (AV2400) — indentation, member order, regions