Add C# Guidelines AI agent skill#400
Merged
Merged
Conversation
Introduces a new Copilot agent skill under Skills/csharp-guidelines/
that captures all coding and design guidelines from this repository.
- SKILL.md: entry point with YAML frontmatter (user-invocable), severity
legend, and one summary table per guideline category with rule IDs,
severity levels and one-line descriptions.
- 11 reference files under references/ with full rule text, code examples
and rationale — one file per category:
general, class-design, member-design, misc-design, maintainability,
testability, naming, performance, framework, documentation, layout.
Highlights:
- Includes new rules introduced since the last published version:
AV0100-series (General), AV1600-series (Testability), AV1145/1150/1155
(C# 14 extension members, local functions, field keyword), AV2225
(deconstruction), AV2308 (document purpose not implementation),
AV1582 (raw string literals), AV1585 (required properties).
- AV1500 correctly states the 15-statement limit (not 7).
- AV1755 correctly documents the nuanced async suffix rule.
- AV2202 updated with C# 14 null-coalescing assignment example.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
SKILL.md is now a lean index with section links only. All 11 reference files reduced to a single-line description per rule — no code examples, no copied guideline text. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Each rule ID now hyperlinks to its section on https://csharpcodingguidelines.com. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a new Copilot AI agent skill (
Skills/csharp-guidelines/) that captures all of the coding and design guidelines defined in this repository. The skill is designed to be invoked by an AI agent when writing, reviewing or refactoring C# code.Structure
Key highlights
SKILL.mdhas YAML frontmatter withuser-invocable: trueand a comprehensive description so agents know when to apply it. Each section is a compact summary table linking to the relevant reference file.fieldkeywordrequiredproperties (C# 11+)