decomment
Automated comment stripping that removes clutter while preserving linter directives and TODOs across any language.
Free
Works with the AI tools you already use
Claude Code
Cursor
Codex CLI
GitHub Copilot
Gemini CLI+20 moreClaude CodeCursorCodex CLIGitHub CopilotGemini CLI
OpenClaw
Manus
Grok+17 agentsdecomment
Example session with this skill installed
Clean up the comments in auth_service.py and user_controller.ts. Keep any TODOs.
- Read your context and instructions
- Compiled the decomment
I have stripped all documentation, inline comments, and section headers from the specified files while preserving tool directives and TODO markers.
Code Cleanup Summary
| File | Comments Removed | Exceptions Kept | Status |
|---|---|---|---|
auth_service.py | 14 | 1 (TODO) | Cleaned |
user_controller.ts | 23 | 3 (ESLint directives) | Cleaned |
// user_controller.ts (Partial view)
import { Request, Response } from 'express';
import { UserService } from './user.service';
export class UserController {
private userService: UserService;
constructor() {
this.userService = new UserService();
}
// TODO: Implement rate limiting for this endpoint
async getUser(req: Request, res: Response) {
/* eslint-disable-next-line @typescript-eslint/no-explicit-any */
const { id } = req.params as any;
const user = await this.userService.findById(id);
return res.json(user);
}
}
Next steps
- Run your linter to ensure no remaining directives were missed.
- Verify that any removed docstrings weren't required for your IDE's autocomplete.
- Commit the changes to your feature branch.
Connects securely to your tools. The creator never sees your data.
About this skill
The problem
AI generated code often includes excessive explanatory comments and docstrings that clutter your codebase. Manual cleanup is tedious, prone to human error, and slows down the PR process.
What it does
- Identifies and removes all line, block, and inline trailing comments across any programming language.
- Deletes JSDoc, docstrings, and section dividers without impacting functional logic.
- Detects and preserves critical compiler directives like
eslint-disableortype: ignore. - Retains
TODOandFIXMEmarkers to ensure outstanding tasks are not lost during cleanup. - Handles bulk processing across files or specific directories with precise
str_replaceedits.
Why this beats prompting it yourself
Generic prompts often result in the AI "judging" which comments are useful, leading to inconsistent results. This skill enforces a zero-tolerance policy for documentation while safely protecting shebangs and linter instructions that actually affect build behavior.
Use cases
- Cleaning up AI-generated "chatter" comments before committing code to a repository.
- Stripping internal developer notes and dividers from a production-ready file.
- Minifying configuration files (YAML, JSON5, TOML) by removing all non-functional text.
- Standardizing code style across a legacy codebase by removing outdated documentation.
Known limitations
Will remove JSDoc and Python docstrings even if they are used to generate external API documentation unless explicitly told to skip them.
How to install
Works the same in every agent - Claude, Cursor, Codex, Copilot and 20+ more.
- 1
Download the ZIP
Free skills download straight away. Paid skills unlock right after purchase.
- 2
Unzip into your skills folder
Every agent reads skills from one folder on your machine. Drop the unzipped folder in there.
- 3
Ask your agent to use it
Restart the agent if it was already running. It picks the skill up automatically - no config needed.
Skills folder by agent
Click the path to copy it. Create the folder if it does not exist yet.
Reviews
4 people have installed this skill.
Trust & safety
Security scanned
Verified clean 26 days ago
- Free to download with an account