accelint-ts-documentation

Audit TypeScript code and add missing JSDoc comments.

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/Ahnd6474/Jakal-flow --skill accelint-ts-documentation-ahnd6474
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: accelint-ts-documentation
Source: https://github.com/Ahnd6474/Jakal-flow/tree/main/.skill-staging/skills/accelint-ts-documentation
Command: npx skills add https://github.com/Ahnd6474/Jakal-flow --skill accelint-ts-documentation-ahnd6474

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

Many TypeScript projects lack consistent JSDoc comments and quality comment markers, leading to unclear APIs and maintenance headaches.

Core Features & Use Cases

  • Comprehensive JSDoc audits: Checks functions, classes, types, and constants for required tags such as @param, @returns, @example, and @throws.
  • Comment quality enforcement: Detects missing TODO/FIXME markers, removes dead code comments, and ensures proper comment placement.
  • Edge‑case guidance: Provides detailed instructions for generics, overloaded functions, and complex object parameters.

Quick Start

Ask the skill to audit the documentation of src/utils/math.ts and suggest improvements.

Frequently Asked Questions about accelint-ts-documentation

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

FAQPage Schema
How do I audit JSDoc comments in a TypeScript project?

To audit JSDoc comments in a TypeScript project, you can analyze source files to identify missing tags like @param, @returns, @example, and @throws across functions, classes, types, and constants. This process ensures comprehensive API documentation standards and consistency.

What is the best way to standardize TODO and FIXME markers in TypeScript code?

Standardizing TODO and FIXME markers in TypeScript code involves scanning the codebase to detect missing comment markers, remove dead code comments, and ensure proper comment placement. This approach maintains consistent comment quality and tracking across your project.

How do I add JSDoc comments for TypeScript generic functions and overloaded methods?

Adding JSDoc comments for TypeScript generic functions and overloaded methods requires applying edge-case guidance for complex object parameters. You must validate proper tag placement and code fence usage against reference markdown files to document type signatures accurately.

Can I use this JSDoc audit on a TypeScript codebase with no existing comments?

Yes, you can audit a TypeScript codebase with no existing comments. The process checks functions, classes, types, and constants to add missing JSDoc comments from scratch, ensuring required tags are present and comment markers are consistent.

What reference files are needed to validate TypeScript documentation standards?

Validating TypeScript documentation standards requires access to source files and reference markdown files, specifically jsdoc.md and comments.md. These references are used to validate JSDoc tags, code fence usage, and proper comment placement during the audit.