github-issue-creator
Creates GitHub issues using gh CLI. Use when creating new issues.
When & Why to Use This Skill
This Claude skill automates the creation of GitHub issues using the GitHub CLI (gh), streamlining the project management workflow for developers. It enhances documentation quality by automatically detecting repository-specific templates, enforcing titling guidelines, and supporting multi-repository management, ensuring that bug reports and feature requests are professional and actionable.
Use Cases
- Bug Reporting: Quickly document software defects by automatically applying the correct bug report templates and labels to ensure technical clarity.
- Feature Requests: Streamline the proposal of new enhancements by following repository-specific guidelines and structures directly from the chat interface.
- Cross-Repository Management: Create issues in different or remote repositories using the -R flag without needing to switch local directories or browser tabs.
- Workflow Standardization: Maintain team consistency by enforcing standardized titling formats and utilizing predefined issue templates for all project contributions.
| name | github-issue-creator |
|---|---|
| description | Creates GitHub issues using gh CLI. Use when creating new issues. |
GitHub Issue Creator
Creates GitHub Issues using GitHub CLI.
Procedure
Confirm Issue Type
Understand the user's intent: bug report, feature request, or other type. Check if labels, assignees, or milestones are specified.
Detect Templates
Detect Issue templates. Filenames are case-insensitive.
Single file template locations (in priority order):
.github/issue_template.mdissue_template.md(repository root)docs/issue_template.md
Multiple templates directory locations:
.github/ISSUE_TEMPLATE/ISSUE_TEMPLATE/(repository root)docs/ISSUE_TEMPLATE/
If a single file template is found, read and use it. If a templates directory is found, list available templates and ask the user which one to use. If no templates exist, use templates/default.md.
Create Issue
Create the Issue with gh issue create and report the Issue URL to the user.
Title Guidelines
The title should be a natural language sentence summarising the issue. Do not use commit message format (e.g., "fix(auth): bug").
Good examples:
- ログイン時にセッションタイムアウトが発生する
- ダークモード切り替え機能を追加したい
- Login session timeout occurs unexpectedly
Bad examples:
- fix(auth): session timeout bug
- Bug
Language
Write issue content in Japanese by default. If the user explicitly requests English, write in English.
Creating Issues in Different Repositories
Use the -R flag to create an issue in a repository different from the current directory.
gh issue create -R OWNER/REPO --title "<title>" --body "<body>"