motlin/comment-cleanup
plugins/code/skills/comment-cleanup/SKILL.md
Guidelines for comments in code. Use when adding, editing, or removing comments.
$ install --global
skillsauthnpx skillsauth add motlin/claude-code-plugins comment-cleanupInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 19, 2026, 4:10 AM19.5s1 file scanned
SKILL.md
- name:
- comment-cleanup
- description:
- Guidelines for comments in code. Use when adding, editing, or removing comments.
Comment Guidelines
- Use comments sparingly
- Don't comment out code
- Remove it instead
- Don't add comments that describe the process of changing code
- Comments should not include past tense verbs like added, removed, or changed
- Example:
this.timeout(10_000); // Increase timeout for API calls - This is bad because a reader doesn't know what the timeout was increased from, and doesn't care about the old behavior
- Don't add comments that emphasize different versions of the code, like "this code now handles"
- Do not use end-of-line comments
- Place comments above the code they describe
Related Skills
motlin/finish
tools
VerifiedTrustedCommunity
This skill should be used after completing any task, before returning control to the user. Always run this skill — it handles the case where there's nothing to do.
12SKILL.mdUpdated Apr 19, 2026
motlin/git-workflow
development
VerifiedTrustedCommunity
Commit message format and git workflow rules. ALWAYS use this skill for every git commit — no exceptions — and whenever rewording an existing commit message.
12SKILL.mdUpdated Apr 19, 2026
motlin/cli
tools
VerifiedTrustedCommunity
CLI guidelines. Use whenever using the Bash tool, which is almost always. Also use when you see "command not found: __zoxide_z" errors.
11SKILL.mdUpdated Apr 19, 2026
motlin/maven-cli
tools
VerifiedTrustedCommunity
Maven CLI invocation patterns. Use whenever running `mvn` commands in Java/Maven projects. Covers when `-am` is required, why `-o` (offline) mode hides bugs in multi-worktree setups, and how to verify compile/test cleanly without trusting stale `~/.m2` artifacts.
10SKILL.mdUpdated May 7, 2026