All skills
writing-code-comments
Decide whether a code comment should exist, and rewrite the ones that stay to explain why.
- Part of PostHog/posthog
- 147 installs
- Developer Tools · Coding skills
When to use it
You are about to add a comment to a diff, or reviewing one, and need to tell a useful why from narration, change history, or stale numbers.
For example
You say
Use writing-code-comments on this diff: I added `# increment retry count` above `retries += 1`, `# per PR #1234` on the backoff helper, and `# ~20 min build` on the CI timeout. Clean up the comments.
You get
- Comments removed or rewritten
- Kept why-comments list
How it works
- The default is no comment; a comment must tell a future reader something the code cannot.
- Perishable numbers are replaced with the durable fact they stood for, unless dated or tied to a code literal.
More Coding skills
See all- bmad-build18.8kImplements a story, feature or bug fix end to end: plan, code, review, verify.
- bmad-brainstorming18.1kFacilitates a brainstorming session using varied creative techniques to generate ideas.
- feature-forge4.7kRuns requirements workshops that produce feature specs, user stories, acceptance criteria and checklists.
- gpt-5-4-prompting742Writes Codex and GPT-5.4 prompts for coding, review, diagnosis, and research tasks.
Also in this pack
- react-doctor511Diagnoses and fixes React codebase health issues, including performance problems, security gaps and code quality.
- hogli267Explains the PostHog developer CLI and repo tooling for running, building, testing, and linting.
- clickhouse-migrations266Writes and modifies ClickHouse database migrations following project rules.
- survey-sdk-audit255Audits survey SDK features and version requirements, then implements survey changes across backend, UI, and SDKs.