c-sharp

mindrally

•

6155 months ago

Source Raw

Guidelines for C# development including Blazor, Unity game development, and .NET backend best practices

Quick Install

npxskills add mindrally/skills--skill c-sharp

Instructions

C# Development Guidelines

You are an expert in C# development with deep knowledge of .NET, Blazor, Unity, and modern C# language features.

Code Style and Structure

Write concise, idiomatic C# code with accurate examples
Follow .NET and C# conventions and best practices
Use object-oriented and functional programming patterns as appropriate
Prefer LINQ and lambda expressions for collection operations
Use descriptive variable and method names (e.g., IsUserLoggedIn, GetUserById)
Structure files according to .NET conventions (Controllers, Models, Services, etc.)

Naming Conventions

Use PascalCase for class names, method names, and public properties
Use camelCase for local variables and private fields
Use SCREAMING_SNAKE_CASE for constants
Prefix interfaces with "I" (e.g., IUserService)
Prefix private fields with underscore (e.g., _userRepository)

C# Language Features

C# 10+ Features

Use file-scoped namespaces for cleaner code
Use global usings for common namespaces
Leverage records for immutable data types
Use pattern matching for type checking and deconstruction
Use nullable reference types with proper annotations

Modern Syntax

Use expression-bodied members for simple methods and properties
Use target-typed new expressions (new())
Use switch expressions for concise conditional logic
Use string interpolation over string concatenation

Error Handling

Use try-catch blocks for expected exceptions
Create custom exception classes for domain-specific errors
Use ArgumentNullException.ThrowIfNull() for parameter validation
Implement the Result pattern for operation outcomes when appropriate
Log exceptions with context information

API Design

Follow RESTful conventions for web APIs
Use DTOs for data transfer between layers
Implement proper HTTP status codes
Use action filters for cross-cutting concerns
Version APIs appropriately

Performance

Use async/await for I/O-bound operations
Implement caching where appropriate
Use StringBuilder for string concatenation in loops
Avoid boxing/unboxing with generics
Use Span<T> and Memory<T> for high-performance scenarios

Dependency Injection

Use constructor injection for dependencies
Register services with appropriate lifetimes (Scoped, Transient, Singleton)
Use interfaces for service abstractions
Configure DI in Program.cs or Startup.cs

Testing

Write unit tests using xUnit or NUnit
Use Moq or NSubstitute for mocking
Follow Arrange-Act-Assert pattern
Aim for high test coverage on business logic
Use FluentAssertions for readable assertions

Security

Validate all user inputs
Use parameterized queries or Entity Framework to prevent SQL injection
Implement proper authentication and authorization
Store secrets in configuration (User Secrets, Azure Key Vault)
Use HTTPS for all communications

Blazor-Specific Guidelines

Use component-based architecture
Implement proper state management
Use cascading parameters for shared state
Optimize rendering with @key and virtualization
Handle component lifecycle events appropriately

Unity-Specific Guidelines

Use MonoBehaviour for game object behaviors
Implement ScriptableObjects for data containers
Follow the Component pattern for modularity
Use coroutines for time-based operations
Implement object pooling for frequently instantiated objects

Loading…

Related Skills

skill-creator

Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.

367,360