code-docs-cleanup

80 / 100 · Low risk

Fine to try.

By grimoire-rs/grimoire (GitHub) · coding · 15 stars · scanned at commit 32b8d4b

Clause-by-clause procedure for shortening and cleaning up source-code comments without losing a guard, the comment that says why a non-obvious line must stay as it is and what breaks if it changes. Use when someone asks to shorten, trim or clean up comments, says a file has too many or overly verbose comments or is over-commented, cut comment density or comment bloat, split an essay comment or an over-long doc comment or docstring, move design rationale out of code into a decision record, remov…

Works with any agent that supports SKILL.md skills.

What this skill can do

Downloads and installs other software

The author does not mention this.

Found in 2 places.

.agents/skills/code-docs-cleanup/SKILL.md, line 235as `uv run pytest -k NAME`, `npx vitest run FILE -t NAME` or `go test -run NAME ./pkg/`,
.agents/skills/code-docs-cleanup/SKILL.md, line 236or the lint or type check itself (`cargo clippy`, `tsc --noEmit`, `npx pyright`).

Connects to the internet

The author does not mention this.

Found in 1 place.

.agents/skills/code-docs-cleanup/references/reason-recheck.md, line 81DENY=(Edit Write NotebookEdit WebFetch WebSearch Agent Task)

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'code-docs-cleanup' ] || [ -L ~/.agents/skills/'code-docs-cleanup' ]; then echo 'A skill folder named code-docs-cleanup already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/grimoire-rs/grimoire' "$d" && git -C "$d" checkout --quiet '32b8d4b63c9de07775ff256850457ac7ae062529' -- '.agents/skills/code-docs-cleanup' && mkdir -p ~/.agents/skills && cp -R "$d"/'.agents/skills/code-docs-cleanup' ~/.agents/skills/'code-docs-cleanup' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'code-docs-cleanup' ~/.claude/skills/'code-docs-cleanup' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for grimoire-rs/grimoire shows the score of its lowest-scoring skill.

SkillTrust badge for grimoire-rs/grimoire

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/grimoire-rs/grimoire.svg)](https://zalavijaysinh.github.io/skilltrust/repos/grimoire-rs/grimoire/)

Score history

Date	Version	Score
2026-11-12	`32b8d4b`	80
2026-11-08	`c5e3824`	80

Also found in

Identical copies of this skill exist at:

grimoire-rs/grimoire/.claude/skills/code-docs-cleanup