Which programming languages does this documentation skill support?

It provides specialized formatting and deep support for TypeScript/JavaScript using JSDoc/TSDoc and Python using standard docstring formats.

Can I use the output with automated documentation tools?

Yes, the documentation is specifically designed to be compatible with tools like TypeDoc for TypeScript and Sphinx or pdoc for Python.

Does it include code examples in the documentation?

Yes, the skill automatically generates usage examples for public functions and classes to demonstrate exactly how the code should be implemented.

How does this improve code maintainability?

By documenting the reasoning behind complex logic and architectural decisions ('why' rather than 'what'), it provides essential context for future maintainers.

Will this skill add comments to every line of my code?

No, it follows an opinionated workflow that skips trivial helpers and obvious getters, focusing instead on public APIs, complex logic, and non-obvious decisions.

Inline Code Documentation

Name: Inline Code Documentation
Author: troykelly

bytroykelly

0•

Learning & Documentation

Generates comprehensive, generator-ready inline documentation including JSDoc, docstrings, and strategic comments for TypeScript and Python.

The Inline Documentation skill automates the creation of high-quality, professional code comments designed for automated documentation generators like TypeDoc or Sphinx. It ensures that public APIs, classes, and complex logic are properly explained using standardized formats like JSDoc for TypeScript/JavaScript and Docstrings for Python. By adhering to the 'why, not what' principle, this skill improves code maintainability and team onboarding while providing practical usage examples to make your codebase more discoverable and easier to use for future developers.

Key Features

01Enforcement of documentation best practices to avoid redundant or stale comments

02Contextual inline comments explaining complex logic and non-obvious decisions

03Full JSDoc and Python Docstring generation for all public APIs and classes

04Automated usage examples for functions and classes to improve discoverability

05Compatibility with industry-standard generators like TypeDoc, Sphinx, and pdoc

060 GitHub stars

Use Cases

01Onboarding new developers by explaining the 'why' behind complex architectural decisions

02Standardizing documentation formats across a large multi-language codebase

03Preparing a library or SDK for automated documentation site generation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add troykelly/claude-skills inline-documentation

For use in Claude.ai and ChatGPT

Key Features

01Enforcement of documentation best practices to avoid redundant or stale comments

02Contextual inline comments explaining complex logic and non-obvious decisions

03Full JSDoc and Python Docstring generation for all public APIs and classes

04Automated usage examples for functions and classes to improve discoverability

05Compatibility with industry-standard generators like TypeDoc, Sphinx, and pdoc

060 GitHub stars

Use Cases

01Onboarding new developers by explaining the 'why' behind complex architectural decisions

02Standardizing documentation formats across a large multi-language codebase

03Preparing a library or SDK for automated documentation site generation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add troykelly/claude-skills inline-documentation

For use in Claude.ai and ChatGPT