csharp-docs

Document C# types with XML comments for .NET libraries and APIs.

Updated Nov 5, 2025
One-click install
npx skills add https://github.com/mkazimoto/AppMAUICopilot --skill csharp-docs-mkazimoto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: csharp-docs
Source: https://github.com/mkazimoto/AppMAUICopilot/tree/main/.github/skills/csharp-docs
Command: npx skills add https://github.com/mkazimoto/AppMAUICopilot --skill csharp-docs-mkazimoto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

C# codebases often lack consistent XML documentation, making APIs hard to discover and hard to reason about. This Skill provides a structured approach to documenting public and internal members using XML comments, with guidance to maintain clarity and consistency across projects.

Core Features & Use Cases

  • Enforce XML documentation on public members and offer recommended practices for internal members.
  • Provide guidance for <summary>, <remarks>, <param>, <returns>, <see>, <seealso>, and <inheritdoc> usage to create comprehensive API docs.
  • Improve maintainability and generate accurate API reference docs for libraries and frameworks.

Quick Start

Add XML documentation comments to a sample class and generate an API reference document with your preferred tool.

Frequently Asked Questions about csharp-docs

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

FAQPage Schema
How do I add XML comments to C# public members for API documentation?

To add XML comments to C# public members, insert tags like <summary>, <param>, and <returns> directly above classes, methods, and properties. This XML documentation improves API clarity and maintainability by ensuring consistent documentation across public surfaces in .NET libraries.

What C# XML documentation tags should I use for comprehensive API docs?

For comprehensive C# API docs, use <summary> for brief descriptions, <remarks> for details, <param> and <returns> for method signatures, <see cref> for cross-references, <example> for code samples, and <inheritdoc> to inherit base member documentation.

Does .NET require XML documentation on internal members or only public APIs?

XML documentation in .NET is enforced on public members to ensure API discoverability, while offering recommended practices for internal members. This approach maintains consistency across projects without imposing strict requirements on every internal type.

What's the best way to generate API reference docs from C# XML comments?

The best way to generate API reference docs from C# XML comments is to apply structured XML tags across public surfaces and use your preferred documentation generation tool. Consistent <summary> and <see cref> usage ensures accurate reference output for .NET libraries.

When should I use the inheritdoc tag in C# XML documentation?

Use the <inheritdoc> tag in C# XML documentation when implementing interfaces or overriding base class members to automatically inherit their XML comments. This prevents duplicate documentation and maintains consistency across inherited public APIs.

Why does my C# codebase lack consistent API documentation across projects?

C# codebases lack consistent API documentation when there are no structured guidelines for XML comments. Applying standardized practices for <summary>, <remarks>, and <see cref> tags across public and internal members ensures maintainability and improves API discoverability.