Gates whether a code comment should exist and forces the ones that stay to explain why, not what. Use ALWAYS before writing or editing a comment in any language (Python, TypeScript, Go, Rust, SQL), and when reviewing a diff that adds comments.
Install
npx skills add PostHog/posthog --skill writing-code-commentsnpx skills add PostHog/posthog --skill writing-code-comments -a claude-code -gnpx skills add PostHog/posthog --skill writing-code-comments -a codex -ggemini skills install https://github.com/PostHog/posthog.git --path .agents/skills/writing-code-commentsgh skill install PostHog/posthog writing-code-commentsgit clone --depth 1 https://github.com/PostHog/posthog /tmp/PostHog__posthog
mkdir -p ~/.claude/skills ~/.agents/skills
cp -R /tmp/PostHog__posthog/.agents/skills/writing-code-comments ~/.claude/skills/writing-code-comments # Claude Code
cp -R /tmp/PostHog__posthog/.agents/skills/writing-code-comments ~/.agents/skills/writing-code-comments # Codex, Cursor, Gemini CLI, Copilot, OpenCode