kdoc-documentation

Document Kotlin APIs with consistent KDoc syntax and cross-references.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/HuxleyMc/Android-Skills --skill kdoc-documentation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kdoc-documentation
Source: https://github.com/HuxleyMc/Android-Skills/tree/main/kdoc-documentation
Command: npx skills add https://github.com/HuxleyMc/Android-Skills --skill kdoc-documentation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Kotlin projects often suffer from inconsistent documentation across public and internal APIs. This skill provides clear guidelines for documenting code using KDoc syntax, best practices, and cross-references to produce reliable API references.

Core Features & Use Cases

  • KDoc syntax coverage: describe short summaries, detailed explanations, parameters, returns, and exceptions with Markdown support.
  • Dokka-ready patterns: guidance on generating HTML and multi-module documentation.
  • Cross-referencing and examples: how to link related classes, provide usage samples, and maintain consistent style.

Quick Start

Use this skill to structure Kotlin documentation for a module by creating SKILL.md with the described frontmatter and content, then follow the examples to write KDoc in your source files.

Frequently Asked Questions about kdoc-documentation

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

FAQPage Schema
How do I write KDoc comments for a Kotlin API?

KDoc comments for a Kotlin API use specific syntax inside block comments to provide short summaries, detailed explanations, parameter descriptions, return values, and exceptions, fully supporting Markdown formatting for reliable API references.

What is the best way to document Kotlin internal and public APIs consistently?

The best way to document Kotlin APIs consistently is to follow standardized KDoc guidelines covering syntax, tags, cross-references, and usage samples to produce reliable library documentation across projects.

How do I generate HTML documentation from KDoc using Dokka?

Generating HTML documentation from KDoc using Dokka involves applying Dokka-ready patterns to structure your comments, which supports creating multi-module documentation and reliable API references for Kotlin projects.

Can I use Markdown formatting inside KDoc code comments?

Yes, you can use Markdown formatting inside KDoc code comments. The syntax explicitly supports Markdown usage for detailed explanations, cross-referencing related classes, and providing usage samples within Kotlin source files.

How do I cross-reference related classes in Kotlin documentation?

To cross-reference related classes in Kotlin documentation, apply specific KDoc tag patterns to ensure consistent style and reliable API references across project modules.