csharp-docs

Enforce XML documentation comments on public and internal C# members.

Updated Dec 28, 2025
One-click install
npx skills add https://github.com/74nu5/Narratum --skill csharp-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: csharp-docs
Source: https://github.com/74nu5/Narratum/tree/main/.github/skills/csharp-docs
Command: npx skills add https://github.com/74nu5/Narratum --skill csharp-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures that C# code is well-documented using XML comments, improving code readability, maintainability, and enabling automatic documentation generation.

Core Features & Use Cases

  • Enforces XML Comment Standards: Guides developers on using standard XML documentation tags (<summary>, <remarks>, <param>, etc.).
  • Improves Code Discoverability: Makes it easier for other developers (and your future self) to understand how to use classes, methods, and properties.
  • Use Case: When writing a new C# library, use this Skill to ensure all public APIs are documented correctly, generating IntelliSense documentation for users.

Quick Start

Ensure all public members in the C# project are documented with XML comments.

Frequently Asked Questions about csharp-docs

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

FAQPage Schema
How do I document C# code using XML comments?

To document C# code using XML comments, apply standard tags like `<summary>`, `<param>`, and `<remarks>` to public and internal members. This practice provides comprehensive API documentation, enabling automatic generation of readable reference files and IntelliSense support.

What is the best way to enforce XML documentation standards for a C# library?

Enforcing XML documentation standards for a C# library involves systematically applying Microsoft's best practices to all public APIs. Ensure every parameter, return value, exception, and type parameter is documented to improve overall code maintainability and discoverability.

Do I need XML comments for internal members in C#?

Yes, you need XML comments for internal members in C# to ensure comprehensive API documentation. Documenting internal members alongside public ones improves code discoverability and helps developers understand how to correctly use classes, methods, and properties.

Why does adding XML comments improve C# code maintainability?

Adding XML comments improves C# code maintainability by making it easier for other developers and your future self to understand the codebase. Standardized documentation tags generate automatic IntelliSense support, clarifying how to use classes, methods, and properties effectively.

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

For C# API documentation, you should use standard XML tags such as `<summary>`, `<remarks>`, `<param>`, and `<returns>`. These tags document parameters, return values, exceptions, and type parameters, ensuring comprehensive coverage and enabling automatic documentation generation.