mcpField
T
trim-comments

trim-comments

github.com/lwlee2608Development1171 installsUpdated today
Repository

About trim-comments

A skill for reducing comment noise in code, with normal and aggressive modes. It limits edits to comments in changed code unless broader scope is requested, and never changes executable lines.

Key features

  1. 01Normal mode shortens comments
  2. 02Aggressive mode removes most comments
  3. 03Preserves TODO, FIXME, and HACK in normal mode
  4. 04Limits scope to changed code by default
  5. 05Protects directives and license headers

Use cases

  1. 01Condensing comments in a local diff
  2. 02Removing comments when explicitly requested
  3. 03Keeping workaround rationale while trimming
  4. 04Reviewing comment cleanup without code changes

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/lwlee2608/agent-skills --skill trim-comments

After installing, type/trim-commentsin Claude Code to confirm it loaded.

Details

From the project README

Trim Comments

Reduce comment noise. normal (default) shortens wordy comments but keeps their meaning — shorter, not cryptic; never deletes. aggressive deletes nearly every comment. Use aggressive only when the user says so ("aggressive", "strip", "remove all").

Two rules always hold:

  • Edit comments only — never change a line of executable code.
  • Scope: unless the user names files, trim only changed code — the uncommitted local diff first, then the PR diff. Touch the whole codebase only when explicitly asked.

What each mode does

COMMENT TYPE                          NORMAL              AGGRESSIVE
─────────────────────────────────────────────────────────────────────
Restatement (// create user)          shorten             DELETE
Narration (// loop over users)        shorten             DELETE
Echo docstring (Gets name)            shorten             DELETE
Plain why-comment                     keep (shortened)    DELETE
TODO / FIXME / HACK                   keep                DELETE
Doc comment (godoc etc.)              keep (shortened)    stub if lint needs it, else DELETE
Unusual workaround / gotcha           keep (shortened)    KEEP but trim shorter
─────────────────────────────────────────────────────────────────────
Tooling directives (//go:generate…)   never touch         never touch
License / copyright headers           never touch         never touch

Notes

  • Unusual workaround = a non-obvious gotcha, a bug being worked around, a "must do X or Y breaks" note. Aggressive keeps these but trims to the shortest form that still conveys the reason.
  • Tooling directives (//go:generate, //go:embed, # noqa, # type: ignore, // eslint-disable, // @ts-expect-error, // nolint) and license headers look like comments but aren't noise — deleting them changes behavior or has legal weight. Never touch them at either level.

Comments

Markdown supported