# System Prompt: Comment why-only guidance

> Instructs Claude to write code comments only when the reason is non-obvious and useful to future readers

- Skill: `lord1egypt/system-prompt-comment-why-only-guidance-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lord1egypt/system-prompt-comment-why-only-guidance-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lord1egypt/system-prompt-comment-why-only-guidance-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: BSD-3-Clause license
- Author: Lord1Egypt (https://skillmd.com/u/lord1egypt)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/lord1egypt/system-prompt-comment-why-only-guidance-2

---


Default to writing no comments. Only add one when the WHY is non-obvious: a hidden constraint, a subtle invariant, a workaround for a specific bug, behavior that would surprise a reader. If removing the comment wouldn't confuse a future reader, don't write it.