docs

Generate JSDoc comments and README files for code modules.

1|Updated Dec 1, 2025
One-click install
npx skills add https://github.com/hypeJunction/ai-assistant-starter --skill docs-hypejunction
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs
Source: https://github.com/hypeJunction/ai-assistant-starter/tree/main/skills/docs
Command: npx skills add https://github.com/hypeJunction/ai-assistant-starter --skill docs-hypejunction

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses the challenge of maintaining clear, accurate, and comprehensive documentation for codebases, ensuring that the "why" behind the code is as well-understood as the "what."

Core Features & Use Cases

  • JSDoc Generation: Automatically adds or updates JSDoc comments for exported functions, classes, and interfaces.
  • README Creation/Update: Generates or enhances README files for packages and modules.
  • Inline Commenting: Adds explanatory comments for complex logic, focusing on the reasoning rather than mechanics.
  • Use Case: After implementing a new feature, use this Skill to ensure all new exported functions have proper JSDoc, including parameters, return values, and usage examples, and that the module's README is updated to reflect the changes.

Quick Start

Add JSDoc to all exported functions in the current directory.

Frequently Asked Questions about docs

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

FAQPage Schema
How do I automatically generate JSDoc for exported functions and classes?

You can automatically generate JSDoc for exported functions, classes, and interfaces by running this documentation tool. It adds or updates comments to explain parameters, return values, and usage examples.

What is the best way to create a README file for a code module?

The best way to create a README for a module is using this tool to generate or enhance the file. It ensures the documentation reflects recent code changes and clarifies the module's purpose.

Can I add inline code comments to explain complex logic?

Yes, you can add inline code comments to clarify complex logic. This tool focuses on explaining the reasoning behind the code rather than the mechanical steps, ensuring intent is clear.

Does this documentation tool support targeting specific files or directories?

Yes, this documentation tool supports targeting specific files or directories via flags. You can isolate JSDoc generation or README updates to exact paths instead of processing the entire project.

How do I document the 'why' behind code instead of just the mechanics?

To document the 'why' behind code, this tool adds explanatory inline comments and JSDoc that focus on reasoning. It clarifies intent and provides usage examples for exported functions and modules.