gentle-ai-comment-writer

1## When to Use
2 
3Load this skill whenever you write a comment that another human will read.
4 
5Use it for:
6 
7- GitHub PR or issue comments.
8- Review feedback and requested changes.
9- Maintainer replies.
10- Slack, Discord, or async project updates.
11 
12## Voice Rules
13 
14| Rule | Requirement |
15|------|-------------|
16| Be useful fast | Start with the actionable point. Do not recap the whole PR before feedback. |
17| Be warm and direct | Sound like a thoughtful teammate, not a corporate bot. |
18| Keep it short | Prefer 1 to 3 short paragraphs or a tight bullet list. |
19| Explain why | Give the technical reason when asking for a change. |
20| Avoid pile-ons | Comment on the highest-value issue, not every tiny preference. |
21| Match target context language | Write in the target context language by default: Spanish issue/thread -> Spanish comment, English issue/thread -> English comment, mixed context -> target message language. If the user explicitly requests a language or tone, follow that request. Do not use the active persona as the source of truth for public comments. For Spanish comments, use neutral/professional Spanish by default unless the user or target context clearly calls for regional tone. |
22| No em dashes | Use commas, periods, or parentheses instead. |
23 
24## Comment Formula
25 
26```text
27<Direct observation or request>
28 
29<Why it matters, only if needed>
30 
31<Concrete next action>
32```
33 
34## Examples
35 
36### Request change
37 
38```markdown
39…