neo-csharp
Skill7 starsChanged 6 months agoMITView on GitHub
Use this skill when writing, reviewing, debugging, or modernizing C# code in .NET projects. Trigger for .cs/.csproj files, C# language-version questions, nullable reference types, records, pattern matching, async/cancellation, or version-appropriate syntax from C# 10+.
In this repository28 other files it gives its agents.
- AGENTS.mdAGENTS.md
- generate-skillSkill
- neo-azure-pipelinesSkill
- neo-clarificationSkill
- neo-clean-architectureSkill
- neo-code-reviewSkill
- neo-csharp-interface-generatorSkill
- neo-dotnet-ef-coreSkill
- neo-dotnet-minimal-apisSkill
- neo-dotnet-mvcSkill
- neo-dotnetSkill
- neo-dotnet-tag-helperSkill
- neo-dotnet-webapiSkill
- neo-harness-projectSkill
- neo-harnessSkill
- neo-javascriptSkill
- neo-opentelemetrySkill
- neo-prSkill
- neo-python-managerSkill
- neo-pythonSkill
- neo-rabbitmqSkill
- neo-rustSkill
- neo-stop-slopSkill
- neo-sub-agentSkill
- neo-swiftSkill
- neo-swift-uiSkill
- neo-typescriptSkill
- neo-vueSkill
The file
We split this skill into the rules it gives an agent
9 rules. About 0 are common, 4 are distinctive, and 5 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 24
Check .csproj to identify TargetFramework and determine the syntax upper limit:
- Distinctive: line 36
Write high-quality code, prioritizing "syntactic sugar" to improve readability.
- Very specific: line 41
Check if asynchronous operations correctly handle cancellation tokens (CancellationToken).
- Distinctive: line 42
Ensure naming conventions comply with official .NET recommendations.
- Distinctive: line 50
Required Members: Ensure required properties during object initialization.
- Very specific: line 75
Immutability: Use record for Data Transfer Objects (DTO).
- Very specific: line 76
Performance: Use Span<T> and ReadOnlySpan<char> in critical paths.
- Very specific: line 77
Async Safety: Always pass CancellationToken, avoid .Result or .Wait().
- Distinctive: line 85
Ensure the provided code complies with the syntax specifications of the target C# version.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Modern C# (10+) Expert Skill
Trigger On
- The user asks to write, debug, refactor, or review C# code.
- The project directory contains
*.cs,*.csproj, or single-file C# scripts. - The target framework is .NET 6.0 (LTS) and above.
- Code modernization is needed (e.g., converting legacy nested namespaces to File-scoped namespaces).
Workflow
- Perceive (Version Awareness):
- Check
.csprojto identifyTargetFrameworkand determine the syntax upper limit:net6.0: C# 10 (File-scoped namespaces, Global usings).net7.0: C# 11 (Raw string literals, Required members).net8.0: C# 12 (Primary Constructors, Collection Expressions).net9.0: C# 13 (paramscollections,Lockobject).net10.0: C# 14 (Extension members,fieldkeyword).net11.0: C# 15 (Union types, closed hierarchies, collection-spread arguments, labeled break/continue, extension indexers, inline unsafe expressions).
- Check
- Reason (Planning Phase):
- Evaluate the modernization level of the current code to determine the refactoring strategy.
- In lower version environments (like .NET 6), avoid using higher version syntax (like Primary Constructors), but prioritize using File-scoped namespaces.
- In higher version environments, actively adopt new features to reduce boilerplate code.
- Act (Execution Phase):
- Write high-quality code, prioritizing "syntactic sugar" to improve readability.
- Implement strong typing and immutable data structures (
record,record struct). - Utilize Interpolated string handlers and Span
<T>to optimize performance-sensitive paths.
- Validate (Standard Validation):
- Validate the safety of NRT (Nullable Reference Types).
- Check if asynchronous operations correctly handle cancellation tokens (
CancellationToken). - Ensure naming conventions comply with official .NET recommendations.
Feature Roadmap (C# 10 - 15)
C# 10 & 11 (Foundation)
- File-scoped Namespaces: Reduce indentation levels.
- Global Using Directives: Centralize common namespaces management.
- Raw String Literals:
"""..."""easily handle multi-line and special characters. - Required Members: Ensure required properties during object initialization.
- List Patterns:
if (list is [1, 2, ..])powerful collection matching.
C# 12 & 13 (Productivity)
- Primary Constructors: Simplify class-level dependency injection.
- Collection Expressions: Uniformly use
[1, 2, 3]to initialize collections. paramsCollections: Method parameters support various collection types.- Implicit Span Conversion: Handle memory-safe code more naturally.
C# 14 (Language Extensions)
- Extension Members: Extension properties, operators, and static members.
fieldKeyword: Directly access backing fields in property logic.- Null-conditional Assignment:
target?.Property = value;. - Scripting: Support
dotnet run file.csfor direct execution.
C# 15 (Advanced Types & Productivity)
- Union Types:
public union Pet(Cat, Dog, Bird);with exhaustive compiler-checkedswitchexpressions without discarding_. - Closed Hierarchies:
public closed record class State;restricts inheritance strictly within the defining project/assembly for domain safety. - Collection Expression Arguments:
[with(capacity: values.Length * 2), .. values]or[with(StringComparer.OrdinalIgnoreCase), ...]for inline constructor customization. - Labeled Break & Continue: Jump out of deeply nested loops directly with
break outer;andcontinue outer;. - Extension Indexers: Support
this[int index]on extended types. - Localized Unsafe Expressions: Fine-grained
unsafe(...)expressions for localized pointer operations without marking entire methods unsafe.
Coding Standards
- Clean Structure: Prioritize using File-scoped namespaces.
- Immutability: Use
recordfor Data Transfer Objects (DTO). - Performance: Use
Span<T>andReadOnlySpan<char>in critical paths. - Async Safety: Always pass
CancellationToken, avoid.Resultor.Wait().
Deliver
- Version-Optimized Code: Provide the most appropriate modernized syntax code based on the target C# version.
- Modernization Insights: Provide specific refactoring suggestions for upgrading from older C# syntax to new features (e.g., from nested namespaces to File-scoped namespaces).
- Syntax Explanations: Clearly explain the design intent and syntax advantages behind the new C# features used.
Validate
- Ensure the provided code complies with the syntax specifications of the target C# version.
- Validate whether the code follows C# strong typing and Null safety (NRT) principles.
- Confirm the code has good readability and best practices at the pure C# language level (e.g., proper use of
Span<T>,record, etc.).
Documentation
Official References
- What's new in C# 15 (Union types, closed hierarchies)
- What's new in C# 14 (Extension Members, field keyword)
- What's new in C# 13 (params collections, Lock object)
- What's new in C# 12 (Primary Constructors, Collection Expressions)
- What's new in C# 11 (Raw String Literals, Required Members)
- What's new in C# 10 (File-scoped Namespaces, Global Usings)
- Nullable Reference Types
Internal References
- C# Coding Style and Naming Conventions Guide
- C# Anti-Patterns and Best Practices
- Modern C# Patterns Guide
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

