Code Documentation Skill

Comprehensive skill for improving JavaScript/TypeScript documentation, including JSDoc comments, comment markers, and general comment quality.

When to Activate This Skill

Use this skill when the task involves:

JSDoc Documentation

• Adding JSDoc comments to exported functions, types, interfaces, or classes
• Validating JSDoc completeness (missing @param, @returns, @template tags)
• Ensuring JSDoc @example tags use proper code fences
• Documenting object parameters with destructuring using dot notation

Comment Quality

• Identifying and categorizing comments using proper markers (TODO, FIXME, HACK, NOTE, PERF, REVIEW, DEBUG, REMARK)
• Removing unnecessary comments (commented-out code, edit history, obvious statements)
• Preserving important comments (markers, linter directives, business logic)
• Improving comment placement (moving end-of-line comments above code)