typescript-jsdoc-standards

Enforce consistent TypeScript/React JSDoc formatting and English-only comments.

Updated Feb 4, 2025
One-click install
npx skills add https://github.com/DavidKk/vercel-web-scripts --skill typescript-jsdoc-standards
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: typescript-jsdoc-standards
Source: https://github.com/DavidKk/vercel-web-scripts/tree/main/.cursor/skills/typescript-jsdoc-standards
Command: npx skills add https://github.com/DavidKk/vercel-web-scripts --skill typescript-jsdoc-standards

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

TypeScript and React code often suffers from inconsistent comments and missing JSDoc documentation, making functions and classes hard to understand and maintain.

Core Features & Use Cases

  • All exported functions, classes, and interfaces include complete JSDoc describing behavior, parameters, and return values.
  • Comments are strictly in English and follow the standard /** ... */ JSDoc format, improving readability and maintainability.
  • Use during code reviews or as part of a CI lint step to enforce documentation quality and reduce onboarding time for new developers.

Quick Start

Install and run the TypeScript/JSDoc checker on your project to automatically validate comment coverage and formatting.

Frequently Asked Questions about typescript-jsdoc-standards

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

FAQPage Schema
How do I enforce JSDoc comments for exported TypeScript functions?

To enforce JSDoc comments for exported TypeScript functions, use a linting checker to validate that all exported members include complete documentation with @param and @returns tags. This ensures consistent code comments and standard formatting across your codebase.

What is the standard JSDoc format for TypeScript and React code?

The standard JSDoc format for TypeScript and React code requires strictly English comments using the /** ... */ syntax. It must describe behavior, parameters, and return values for all exported functions, classes, and interfaces to improve project maintainability.

Can I use a JSDoc linting checker in my CI pipeline?

Yes, you can use a JSDoc linting checker as part of a CI step to automatically validate comment coverage and formatting. Running it during continuous integration enforces documentation quality and reduces onboarding time for new developers.

How do I check for missing @param and @returns tags in TypeScript?

To check for missing @param and @returns tags in TypeScript, run a documentation validation checker that scans your codebase. It identifies exported functions and classes lacking complete JSDoc requirements, ensuring parameters and return values are properly documented.

Does this JSDoc checker work with React components and interfaces?

Yes, this JSDoc checker works with React components and interfaces. It enforces consistent TypeScript and React code comments across the codebase, ensuring all exported interfaces and components have complete documentation describing their behavior.

Why are inconsistent code comments a problem in TypeScript projects?

Inconsistent code comments and missing JSDoc documentation in TypeScript projects make functions and classes hard to understand and maintain. Enforcing standard formatting and complete documentation reduces onboarding time and improves overall code quality during reviews.