dotnet-docfx

Audit and complete XML doc comments for .NET/C# classes.

Updated Jul 9, 2026
One-click install
npx skills add https://github.com/albertoirurueta/ai-catalog --skill dotnet-docfx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dotnet-docfx
Source: https://github.com/albertoirurueta/ai-catalog/tree/main/.claude/skills/dotnet-docfx
Command: npx skills add https://github.com/albertoirurueta/ai-catalog --skill dotnet-docfx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires docfx, and includes scripts (resource) and assets (resource) components.

What problem does it solve?

This Skill helps ensure that .NET/C# class types have complete and well-formed XML doc-comment coverage, including for private members and nested types, improving documentation quality and code readability.

Core Features & Use Cases

  • Audit XML Doc-Comments: Checks types, fields, properties, methods, and events for missing or incomplete XML comments.
  • Generate Missing Comments: Creates missing XML comments based on the code, filling in descriptions, parameters, and exceptions.
  • DocFX Integration: Optionally generates a documentation report using DocFX to validate the formatting and completeness of doc comments.
  • Use Case: When working on a .NET project and you want to ensure that all public and private types and members have proper documentation.

Quick Start

To audit and fill doc comments for all classes in the current project, use: /dotnet-docfx

Frequently Asked Questions about dotnet-docfx

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

FAQPage Schema
How do I ensure complete XML doc-comment coverage for private and nested .NET types?

To ensure complete XML doc-comment coverage for .NET types, you can audit and automatically generate missing comments for private and nested members. This process fills in descriptions, parameters, and exceptions to improve code readability.

What's the best way to generate missing XML comments for C# classes automatically?

The best way to generate missing XML comments for C# classes is to run an audit that analyzes the code structure. It automatically creates missing descriptions, parameters, and exception tags for fields, properties, methods, and events.

Do I need DocFX installed to audit and complete XML doc comments?

You do not need DocFX installed to complete XML doc comments, but the .NET tool 'docfx' is required for optional validation and generating a report detailing documentation gaps.

How does DocFX validate the formatting and completeness of XML doc comments?

DocFX validates XML doc comments by generating a documentation report that identifies formatting and completeness gaps. This integration checks the documentation coverage across types, fields, properties, methods, and events.

Can I check my C# project for missing XML documentation on methods and properties?

Yes, you can check your C# project for missing XML documentation on methods and properties. The audit scans types, fields, properties, methods, and events, detecting incomplete or missing comments across the entire project.

XML doc comments not generating for private members, how can I audit them?

To audit XML doc comments for private members, run a project-wide scan that targets private and nested types specifically. It detects missing comments and generates the necessary descriptions, parameters, and exceptions automatically.