Code Documentation Skill

Purpose

This skill provides TSDoc format templates, type documentation guidelines, and maintenance workflows. Use this when:

• Writing or editing TSDoc comments for any function, type, or module
• Reviewing documentation quality
• Creating comprehensive API documentation
• Documenting complex type structures
• Cleaning up non-compliant comments (performance notes, timestamps, inline explanations)
• Synchronizing out-of-sync TSDoc with code changes
• Removing orphaned documentation for deleted code

Key Standard: No @example sections - tests and stories serve as living examples.

Quick Reference

• Creating TSDoc: See workflow.md for the generation workflow
• Maintaining TSDoc: See maintenance.md for cleanup and sync guidelines