Prune Comments
Audit code comments and plan which to delete, keep, rewrite or replace with a refactor. Use when asked to prune a codebase's comments, or to sort workaround comments into root-cause fixes and safe deletions.
Install
npx skills add kr4chinin/skills --skill prune-commentsgit clone --depth 1 https://github.com/kr4chinin/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/skills/prune-comments ~/.claude/skills/prune-commentsPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Prune comments
Agents copy what a codebase already does, so every comment is a _precedent_.
A comment that narrates the code teaches narration; one that excuses a
temporary workaround teaches that workarounds are fine here. Prune until the
comments that remain are precedents worth copying: each says what the code
cannot.
The first deliverable is a plan. Edit code only after the user approves it.
## 1. Scope
Use the scope the user gave; with several apps and no hint, ask which. Cover
files tracked by git and any untracked file the user names, marked as
untracked, and report the revision you read. Leave out generated,
vendored and third-party code, lockfiles, snapshots and test fixtures, and
say what you left out.
Read the repository's own comment rules (`AGENTS.md`, CONTRIBUTING, lint
config that requires doc comments). They override this skill. Then list the
tools that read comments here: linters, type checkers, bundler, coverage,
test runner, codegen, migrations, i18n extraction, docs build.
Find comments with a parser: `ast-grep` with `kind: comment`, or the
language's own. `kind: comment` misses docstrings (string nodes in Python)
and doc attributes (`#[doc]`, `@doc`); query those too. List a file with no
parser for its language as unparsed: text search also matches `#` and `//`
in strings, URLs and `${#arr}`.
Done when every in-scope file is parsed or listed as unparsed.
## 2. Classify every commentDetails
- Skill name
prune-comments- Repository
- kr4chinin/skills
- Path
skills/prune-comments/SKILL.md- License
- MIT
- Repo updated
- 16 November 2026
FAQ
What does the Prune Comments skill do?
Audit code comments and plan which to delete, keep, rewrite or replace with a refactor. Use when asked to prune a codebase's comments, or to sort workaround comments into root-cause fixes and safe deletions.
How do I install the Prune Comments skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add kr4chinin/skills --skill prune-comments. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Prune Comments popular?
It lives in kr4chinin/skills, which has 9 GitHub stars and 0 forks.
Related skills
Convert State Machines to Actors
9kr4chinin/skills
Convert a database-backed implicit state machine to an actor, the one owner every writer of the persisted state goes through. Use when asked to put writers behind one owner, or to fix a race or lost update across several writers, such as a find-implicit-state-machines finding.
Find Implicit State Machines
9kr4chinin/skills
Audit a codebase for implicit state machines (state spread across flags, status fields, timers and callbacks). Use when asked to find them or to trace impossible states, stuck loading, missing resets or async races. Catalog machines with no defect only when asked for an inventory.
Recover Semantic Model
9kr4chinin/skills
Recover a program's minimal semantic model (the state that changes what users see, how its transitions repeat and reorder, what each effect requires). Use when asked to recover or audit that model, to check what is idempotent or order-dependent, or to split a refactor into provably equivalent and "trust me" changes.
Revolut X Auth
9revolut-engineering/revolut-agent-skills
Revolut X API authentication setup, Ed25519 keypair generation, and request signing. Use when the user asks to set up Revolut X API access, configure API keys, generate an Ed25519 keypair, sign requests manually, or debug 401/403/409 authentication errors.
Mxl CLI
9TaoELi/MaxwellLink
This skill should be used when users need to initialize, clean, or configure MaxwellLink workspaces using the mxl command family.
Revolut X Public Market Data
9revolut-engineering/revolut-agent-skills
Revolut X public market data — public order book (5 price levels) and latest 100 trades across all pairs. No authentication required. Use when the user wants a quick price check or recent trade data and has not configured API keys, or asks about public market data.
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.