jsdoc

Write concise JSDoc comments for TypeScript code using @default, @example, and @note.

22|3|Updated Sep 12, 2025
One-click install
npx skills add https://github.com/kubb-labs/fabric --skill jsdoc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jsdoc
Source: https://github.com/kubb-labs/fabric/tree/main/.skills/jsdoc
Command: npx skills add https://github.com/kubb-labs/fabric --skill jsdoc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers often struggle to document TypeScript code consistently, and inconsistent documentation hurts maintainability and onboarding. JSDoc provides inline, human-readable explanations that stay close to the code.

Core Features & Use Cases

  • Consistent JSDoc conventions for properties and types in TypeScript code.
  • Emphasis on describing what a property or option does, not repeating type information.
  • Typical tags supported: @default, @example, @note to convey defaults, usage, and caveats.
  • Use cases include documenting library APIs, configuration objects, and complex data structures.

Quick Start

Annotate a sample TypeScript interface with JSDoc comments following the guidelines.

Frequently Asked Questions about jsdoc

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

FAQPage Schema
How do I write JSDoc comments for TypeScript without repeating type information?

To write JSDoc for TypeScript without redundancy, describe what a property does rather than its type. This minimal tagging approach uses @default, @example, and @note to convey defaults, usage, and caveats.

What is the best way to document complex TypeScript configuration objects?

The best way to document complex TypeScript configuration objects is using concise JSDoc comments. Apply tags like @default, @example, and @note to clarify intent, defaults, and caveats close to the code.

When do I need inline documentation for TypeScript library APIs?

You need inline documentation for TypeScript library APIs when explaining usage intent for complex data structures or configuration objects. JSDoc provides human-readable explanations that stay close to the code to improve maintainability.

Does JSDoc work well with TypeScript types and interfaces?

JSDoc works well with TypeScript types by avoiding redundant type repetition. It enforces consistent conventions for properties, focusing on describing what the property or option does rather than restating existing type definitions.

What are the limitations of using a minimal JSDoc tagging approach in TypeScript?

The limitation of a minimal JSDoc tagging approach is that it relies on only @default, @example, and @note tags. It intentionally omits extensive tagging to avoid redundancy with TypeScript types, focusing strictly on inline intent clarification.