dotnet-best-practices

Enforce .NET and C# best practices across selected code ranges.

Updated May 16, 2026
One-click install
npx skills add https://github.com/p-o-ke-nae/pokemondamagecalculatorforstory --skill dotnet-best-practices-p-o-ke-nae
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dotnet-best-practices
Source: https://github.com/p-o-ke-nae/pokemondamagecalculatorforstory/tree/main/.github/skills/dotnet-best-practices
Command: npx skills add https://github.com/p-o-ke-nae/pokemondamagecalculatorforstory --skill dotnet-best-practices-p-o-ke-nae

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps align .NET and C# code with project-specific best practices, reducing inconsistent architecture, missing documentation, weak dependency injection, and unreliable tests.

Core Features & Use Cases

  • Enforces Japanese XML documentation for public types and members, including proper inheritdoc usage for interface implementations.
  • Guides dependency injection, service registration, async patterns, logging, configuration, and error handling toward consistent solution standards.
  • Supports test quality improvements with MSTest, FluentAssertions, Moq, and clear arrange-act-assert structure.
  • Use case: A developer refactoring a service can apply this Skill to make the codebase more maintainable, reviewable, and production-ready.

Quick Start

Apply the dotnet-best-practices skill to the selected .NET code and update it so it follows the repository's documentation, architecture, testing, and error-handling conventions.

Frequently Asked Questions about dotnet-best-practices

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

FAQPage Schema
How do I enforce C# best practices during code review?

To enforce C# best practices during code review, apply this Skill to selected code ranges. It checks SOLID-compliant design, async logging discipline, and validation to ensure your .NET solution remains maintainable and production-ready.

How do I add Japanese XML documentation to public C# types?

Adding Japanese XML documentation to public C# types requires proper inheritdoc usage for interface implementations. This Skill guides the generation of compliant documentation across application, service, and infrastructure code during refactoring.

What is the best way to structure MSTest unit tests in .NET?

The best way to structure MSTest unit tests in .NET is using a clear arrange-act-assert pattern. This Skill improves test quality by integrating FluentAssertions and Moq to align with consistent solution testing standards.

Does this dotnet best practices Skill support primary-constructor dependency injection?

Yes, this dotnet best practices Skill supports primary-constructor dependency injection. It guides service registration, DI patterns, configuration, and error handling toward consistent solution standards across your application and infrastructure code.

Can I use this Skill for refactoring both service and infrastructure code?

Yes, you can use this Skill for refactoring service and infrastructure code. It applies to application, service, infrastructure, and test code, enforcing async patterns, logging discipline, and SOLID-compliant design across the entire solution.

How do I fix missing XML documentation in interface implementations?

Fixing missing XML documentation in interface implementations requires proper inheritdoc usage for public types and members. This Skill enforces Japanese XML documentation standards to reduce missing documentation and improve codebase reviewability.