code-polish
Rewrites unprofessional code comments into clear ones and performs non-semantic cleanup. Use to professionalize code without altering logic or behavior.
Profile →npx skills add sickn33/agentic-awesome-skills --skill code-polish --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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 (
- Prime Directive
- When to Use
- Phase 0 — Full Read
- Phase 1 — Comment Audit
- Phase 2 — Non-Semantic Cleanup
- Phase 3 — Comment Rewrite / Addition
- Phase 4 — Verification
- Phase 5 — Report Back
- Examples
- Security & Safety Notes
- Limitations
What does the code-polish skill do?
Rewrites unprofessional code comments into clear ones and performs non-semantic cleanup. Use to professionalize code without altering logic or behavior.
How do I install it?
Run `npx skills add sickn33/agentic-awesome-skills --skill code-polish --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From sickn33/agentic-awesome-skills, a repository with 44,414 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.