Accelint Ts Documentation

This handles JSDoc comments and comment quality audits for TypeScript and JavaScript codebases. It's built around a two-tier system: exported APIs get comprehensive documentation with all the tags (@param, @returns, @template, @example), while internal code only gets documented when it's not self-evident from the function signature and names. The skill includes detailed guidance on comment markers (TODO, FIXME, HACK), when to remove obvious or outdated comments, and proper @example formatting with code fences. It even has a judgment framework asking who the reader is and whether you're dealing with opacity or complexity. The audit template is thorough, maybe more structured than you need for quick fixes, but solid if you're doing a real documentation review.

skills.sh installs: 263
GitHub stars: 25
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add gohypergiant/agent-skills --skill accelint-ts-documentation --agent claude-code

Installs into .claude/skills of the current project.

Files

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)