Skip to content

Add AGENTS.md and csharp-guidelines agent skill#394

Merged
dennisdoomen merged 1 commit into
masterfrom
dennisdoomen/add-copilot-instructions
Apr 27, 2026
Merged

Add AGENTS.md and csharp-guidelines agent skill#394
dennisdoomen merged 1 commit into
masterfrom
dennisdoomen/add-copilot-instructions

Conversation

@dennisdoomen
Copy link
Copy Markdown
Owner

Summary

Adds agent-agnostic instructions and a structured agent skill so that any AI coding agent (GitHub Copilot, Cursor, Codex, etc.) can automatically apply these C# guidelines when generating or reviewing code.

Files added

File Purpose
\AGENTS.md\ Root-level agent instructions — describes the repo structure, rule format, build commands, and points to the skill
.agents/skills/csharp-guidelines/SKILL.md\ Agent skill with YAML frontmatter and a compact rule index (all 114 rules across 9 categories in table form)
.agents/skills/csharp-guidelines/references/*.md\ Per-category detailed reference files (progressive disclosure — loaded only when the agent needs deeper context)

Design decisions

  • *\AGENTS.md* follows the agents.md open format, compatible with GitHub Copilot, OpenAI Codex, Cursor, Amp, Jules, and others.
  • *\SKILL.md* follows the Agent Skills specification: YAML frontmatter with
    ame\ + \description, compact body under 500 lines, with detailed content split into
    eferences/\ for progressive disclosure.
  • The skill \description\ is written to trigger automatically whenever an agent is generating or reviewing C# code.
  • Reference files are organised by the same 9 categories already used in the site navigation.

- AGENTS.md: agent-agnostic repo instructions (Jekyll site structure,
  rule format, build commands, pointer to the skill)
- .agents/skills/csharp-guidelines/SKILL.md: skill with frontmatter
  and compact rule index across all 9 categories (114 rules)
- .agents/skills/csharp-guidelines/references/*.md: full per-category
  rule details following progressive-disclosure pattern

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@dennisdoomen dennisdoomen merged commit 73e0e4c into master Apr 27, 2026
@dennisdoomen dennisdoomen deleted the dennisdoomen/add-copilot-instructions branch April 27, 2026 08:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant