# Clean Codejs Comments

> Commenting patterns that improve readability and maintainability.

- Skill: `damianwrooby/clean-codejs-comments` (Agent Skill)
- Install (CLI): `npx skillmds@latest add damianwrooby/clean-codejs-comments`
- Raw SKILL.md: https://api.skillmd.com/api/skills/damianwrooby/clean-codejs-comments/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: damianwrooby (https://skillmd.com/u/damianwrooby)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/damianwrooby/clean-codejs-comments

---


# Clean Code JavaScript – Comment Patterns

## Table of Contents
- When to Comment
- When Not to Comment
- Examples

## When to Comment
- Explain **why**, not **what**
- Document complex business rules

## When Not to Comment
- Obvious code
- Outdated explanations

## Examples

```js
// ❌ Bad
// Increment i by 1
i++;

// ✅ Good
// Retry once to handle flaky network condition
retryRequest();
```