Agent skill · software engineering · sickn33
code-polish
Rewrites unprofessional code comments into clear ones and performs non-semantic cleanup. Use to professionalize code without altering logic or behavior.
Why this skill is useful
Adds a structured protocol for normalizing code comments and performing non-semantic cleanup that the AI wouldn't reliably generate on its own.
What it needs
About 6k tokens when loaded. Last updated 2026-08-07. 44,571 stars on the source repository.
What this skill does
Code Polish A constraint-based protocol for normalizing code comments and performing safe, non-semantic cleanup. This skill exists because human-written code tends to carry casual, outdated, or missing comments, while the goal is professional-grade documentation without touching behavior. This file is self-contained. Do not require any other skill file to execute this protocol. Prime Directive Comments and non-semantic cleanup are the job. Logic is never the job. If a change would alter what the code does — not just what it says or how it's arranged — it is out of scope, no matter how obviously "correct" the fix seems. --- When to Use Apply this skill when: The user asks to "clean up," "professionalize," or "polish" existing code Code is being prepped for code review, handoff, open-sourcing, or documentation A file has a mix of human and AI-written comments and needs one consistent, professional voice Comments are outdated, missing, redundant, or written casually (venting, placeholders, inside jokes) The user wants comments improved but explicitly does not want logic touched Do not apply this skill when: The user wants a bug fixed or behavior changed (that's a different job — logic edits are out of scope here) The user wants a full rewrite or architectural restructuring The only ask is adding new features or functionality --- Phase 0 — Full Read Before editing anything, read the entire file (or the entire relevant module if the codebase is large — not just the function in question). Do not comment or clean incrementally while still reading. A comment written without full context is a guess, and guesses are how "professional" comments end up wrong. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sickn33/code-polish--e04f79