analyze-code-commenter

Analyze code and add bilingual zh-TW and English JSDoc comments.

1|1|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/bluelovers/ai-agents-profile --skill analyze-code-commenter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: analyze-code-commenter
Source: https://github.com/bluelovers/ai-agents-profile/tree/main/skills/analyze-code-commenter
Command: npx skills add https://github.com/bluelovers/ai-agents-profile --skill analyze-code-commenter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Skill analyzes code and adds detailed bilingual comments (Traditional Chinese and English) for core logic, internal methods, and protected/private members, without changing the original formatting, to improve maintainability and cross-team understanding.

Core Features & Use Cases

  • Explains Why, not just What, by providing rationale behind key decisions in bilingual comments that accompany core logic and internal methods.
  • Uses JSDoc for methods/classes and inline // comments for complex inline logic, while preserving the original code layout.
  • Applicable to multi-language codebases (e.g., TypeScript, Java, C++, C#) where bilingual documentation aids teamwork and onboarding.

Quick Start

Provide the target source file or project path; the skill will analyze the code and insert bilingual comments for core logic and private/protected members without altering existing formatting.

Frequently Asked Questions about analyze-code-commenter

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

FAQPage Schema
How do I add bilingual code comments to a TypeScript project without changing the formatting?

To add bilingual code comments without altering formatting, provide the target source file or project path for analysis. The skill generates JSDoc-style Traditional Chinese and English comments for classes, methods, and private members while preserving the original code layout.

What is the best way to document internal methods and protected members for cross-team collaboration?

The best way to document internal methods for cross-team collaboration is generating bilingual comments that explain the rationale behind core logic. This approach provides JSDoc for methods and inline comments for complex logic to aid maintenance and onboarding.

Does the bilingual code commenter work with multi-language codebases like Java and C++?

Yes, the bilingual code commenter works with multi-language codebases like Java, C++, and C#. It analyzes the source code and inserts Traditional Chinese and English explanations for core logic and internal mechanisms across these supported languages.

Why do my code comments only explain what the code does instead of the internal mechanisms and decisions?

Code comments often only explain what code does because the rationale behind decisions is missing. This skill solves that by analyzing code to add bilingual comments explaining why core logic and internal mechanisms were implemented that way.

Can I generate JSDoc comments for classes and methods in both zh-TW and English?

Yes, you can generate JSDoc comments for classes and methods in both zh-TW and English. The skill analyzes your code and applies bilingual explanations to core logic, protected members, and private methods without modifying existing formatting.

What are the limitations of automatically adding bilingual comments to existing source files?

A limitation of automatically adding bilingual comments is that the skill focuses strictly on inserting JSDoc and inline explanations without changing original formatting. It does not refactor code logic or translate existing user-facing string content.