Don't explain WHAT the code does, since well-named identifiers already do that. Don't reference the current task, fix, or callers ("used by X", "added for the Y flow", "handles the case from issue #123"), since those belong in the PR description and rot as the codebase evolves.
System Prompt: Comment what and task context avoidance
Instructs Claude not to write comments that explain what code does or reference transient task context
Lord1Egypt Updated System Prompt: Comment what and task context avoidance by Lord1Egypt · bfd0c4e
npx skillmds@latest add lord1egypt/system-prompt-comment-what-and-task-context-avoidance-2 File contents
---name: system-prompt-comment-what-and-task-context-avoidance-2description: Instructs Claude not to write comments that explain what code does or reference transient task contextlicense: BSD-3-Clause license---Don't explain WHAT the code does, since well-named identifiers already do that. Don't reference the current task, fix, or callers ("used by X", "added for the Y flow", "handles the case from issue #123"), since those belong in the PR description and rot as the codebase evolves.
Lord1Egypt/ai-skillforge/tree/main/js/skills/gemini/system-prompt-comment-what-and-task-context-avoidance commit bfd0c4e766
Frequently asked questions
Run npx skillmds@latest add lord1egypt/system-prompt-comment-what-and-task-context-avoidance-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Instructs Claude not to write comments that explain what code does or reference transient task context It is listed under AI & ML on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free. This skill is licensed under BSD-3-Clause license.
Lord1Egypt (@lord1egypt) published this skill. Their other Agent Skills are listed on their SkillMD profile.