github-issues
GitHub issue comment guidelines for community interaction. Use when responding to GitHub issues, bug reports, feature requests, or any GitHub discussion.
When & Why to Use This Skill
This Claude skill provides a comprehensive framework for managing GitHub community interactions with a focus on empathy, clarity, and engagement. It streamlines the process of responding to bug reports, feature requests, and general discussions by offering standardized templates, debugging protocols, and a consistent, approachable brand voice designed to foster a positive developer community.
Use Cases
- Empathetic Bug Handling: Responding to user-reported issues with personalized greetings, sincere apologies for delays, and structured debugging offers to reduce user frustration.
- Feature Implementation Announcements: Communicating the delivery of new features or fixes while giving proper credit to community contributors and providing direct links to releases.
- Community Growth and Retention: Strategically promoting Discord groups and community channels within GitHub discussions to move users further into the project's ecosystem.
- Technical Support Escalation: Facilitating high-touch support by offering direct debugging calls via scheduling links (e.g., Cal.com) for complex technical problems.
- Standardizing Team Communication: Ensuring all maintainers and contributors use a unified, casual, and professional tone when interacting with the public on GitHub.
| name | github-issues |
|---|---|
| description | GitHub issue comment guidelines for community interaction. Use when responding to GitHub issues, bug reports, feature requests, or any GitHub discussion. |
GitHub Issue Comment Guidelines
Opening Pattern
Always start with a personal greeting using the user's GitHub handle:
- "Hey @username, thank you for the issue"
- "Hey everyone, thanks for the notice!"
- "Hey all, thanks for the issue!"
Core Elements
1. Acknowledgment
- Start by acknowledging their issue/contribution
- Express empathy for problems: "sorry to hear this!", "sorry to hear your shortcut was lost!"
- Apologize for delays: "I apologize for the delayed response"
2. Good News Delivery
When announcing features or fixes:
- "good news!" or "Good news!"
- Add celebration emoji sparingly
- Credit contributors: "Thank you for the inspiration" or "Thank you and @user1 and @user2 for the inspiration"
3. Debugging Offers
For complex issues, offer direct help:
- "If you have time, I would love to hop on a call with you, and we can debug this together"
- "Let's hop on a call sometime in the coming days, and I'll debug it with you"
- Always include cal.com link: "https://cal.com/epicenter/whispering"
- Add availability: "I'm free as early as tomorrow"
4. Discord Promotion
When appropriate, mention Discord:
- "PS: I've also recently created a Discord group, and I'd love for you to join! You can ping me directly for more features."
- Include link: "https://go.epicenter.so/discord"
5. Follow-up Questions
Ask clarifying questions to understand the issue better:
- "To clarify, could you confirm that this issue persists even with the latest v7.1.0 installer?"
- "Did you ever get a popup to grant permission to access recording devices?"
- "Does this happen when you make recordings for more than 4 seconds?"
6. Closing
End with gratitude:
- "Thank you!"
- "Thanks again!"
- "Thank you again for your help and will be taking a look!"
- "My pleasure!" (when thanked)
Response Examples
Feature Implementation Response
Hey @username, thank you for the issue, and good news! [Whispering v7.1.0](link) now includes the [feature]! Thank you for the inspiration.
[Brief description of how it works]
PS: I've also recently created a Discord group, and I'd love for you to join! You can ping me directly for more features.
https://go.epicenter.so/discord
Debugging Response
Hey @username, so sorry to hear this! I apologize for the delayed response; I was finalizing [the latest release v7.1.0](link).
To clarify, could you confirm that this issue persists even with the latest v7.1.0 installer?
If you have time, I would love to hop on a call with you, and we can debug this together. You can book a meeting with me using my cal.com link right here, I'm free as early as tomorrow:
https://cal.com/epicenter/whispering
Thank you!
Quick Acknowledgment
Hey @username, sorry to hear [problem]! Did you ever get a fix?
Writing Style Notes
- Use casual, approachable language
- Be genuinely enthusiastic about user contributions
- Reference specific users and give credit
- Link to relevant issues, releases, or commits
- Keep responses personal and conversational
- Avoid corporate or overly formal language