github-issue-helper
GitHub 이슈 작성 도우미. 사용자가 이슈 초안이나 아이디어를 제시하면 고품질 GitHub 이슈로 개선. Use when user asks to (1) write/create/draft a GitHub issue, (2) improve/refine an issue draft, (3) convert an idea into a proper issue format, (4) review issue quality. Supports bug reports, feature requests, and improvement proposals. Communicates in Korean but produces final issues in English.
When & Why to Use This Skill
The GitHub Issue Helper is a specialized Claude skill designed to transform rough ideas, bug reports, and feature requests into professional, high-quality GitHub issues. It bridges the language gap by communicating in Korean while generating structured, English-language documentation. By incorporating clear context, concrete code snippets, and objective solution analysis, it ensures that issues are easily understood by both human contributors and AI coding agents, significantly improving project collaboration and maintainability.
Use Cases
- Bug Report Optimization: Transform rough notes or observations about software defects into detailed, reproducible bug reports with concrete code examples and clear context.
- Feature Request Structuring: Convert vague feature ideas into comprehensive proposals that include clear motivations, benefit analysis, and technical background.
- Multilingual Team Collaboration: Enable Korean-speaking developers to generate high-quality, professional English GitHub issues for international open-source projects or global teams.
- Issue Quality Auditing: Review and refine existing issue drafts to ensure they meet high standards, such as linking related resources and presenting multiple solution options without bias.
- Idea-to-Issue Conversion: Quickly turn brainstorming sessions or rough technical thoughts into structured, actionable tasks within a GitHub repository.
| name | github-issue-helper |
|---|---|
| description | GitHub 이슈 작성 도우미. 사용자가 이슈 초안이나 아이디어를 제시하면 고품질 GitHub 이슈로 개선. Use when user asks to (1) write/create/draft a GitHub issue, (2) improve/refine an issue draft, (3) convert an idea into a proper issue format, (4) review issue quality. Supports bug reports, feature requests, and improvement proposals. Communicates in Korean but produces final issues in English. |
GitHub Issue Helper
Transform rough ideas or drafts into high-quality GitHub issues that contributors and coding agents can easily understand.
Core Principles
Language Rules
- Communicate with user in Korean
- Write final issue output in English
Quality Standards
- Clear Context: Provide enough background for unfamiliar contributors
- Concrete Code Examples: Include snippets showing the problem and solution
- Neutral Stance: Never mark any solution as "Recommended" - best approach varies by context
- Link Related Resources: Reference relevant issues, PRs, and docs
Workflow
- Analyze: Examine user's draft or idea
- Classify: Determine if bug report, improvement, or feature request
- Gather Info: Ask user for missing information if needed
- Research: Search related issues/PRs on GitHub if possible
- Draft: Write issue in English using templates in references/templates.md
- Explain: Provide feedback in Korean about intent and improvements
Template Selection
- Bug Report / Improvement: Use when reporting defects or proposing enhancements to existing functionality
- Feature Request: Use when proposing entirely new capabilities
See references/templates.md for complete templates.
Quality Checklist
Before finalizing, verify:
- Background section provides sufficient context
- Motivation is clear and compelling
- Code examples are included where applicable
- Multiple solution options are presented
- No "Recommended" labels on any option
- Related issues/PRs are linked
- (Feature) Benefits section is clear
- (Feature) Already Answered section addresses common questions
- English grammar and expressions are natural
Key Guidelines
- Present pros/cons objectively for each solution option
- Write code examples that are concrete and runnable
- Assume reader is unfamiliar with the codebase
- Actively use GitHub URLs or issue numbers if provided by user