github-issue-creator

Use this skill when asked to create a GitHub issue. It handles different issue types (bug, feature, etc.) using repository templates and ensures proper labeling.

By google-gemini · 843 installs

npx skills add google-gemini/gemini-cli --skill github-issue-creator

Source repository · Upstream listing

GitHub Issue Creator This skill guides the creation of high quality GitHub issues that adhere to the repository's standards and use the appropriate templates. Workflow Follow these steps to create a GitHub issue: 1. Identify Issue Type : Determine if the request is a bug report, feature request, or other category. 2. Locate Template : Search for issue templates in .github/ISSUE TEMPLATE/ . bug report.yml feature request.yml website issue.yml If no relevant YAML template is found, look for .md templates in the same directory. 3. Read Template : Read the content of the identified template file to understand the required fields. 4. Draft Content : Draft the issue title and body/fields. If using a YAML template (form), prepare values for each id defined in the template. If using a Markdown template, follow its structure exactly. Default Label : Always include the 🔒 maintainer only label unless the user explicitly requests otherwise. 5. Create Issue : Use the gh CLI to create the issue. CRITICAL: To avoid shell escaping and formatting issues with multi line Markdown or complex text, ALWAYS write the description/body to a temporary file first. For Markdown Templates or Simple Body: For YAML Templates (Forms): While gh issue create supports body file , YAML forms usually expect key value pairs via flags if you want to bypass the interactive prompt. However, the most reliable non interactive way to ensure formatting is preserved for long text fields is to use the body or body file if the form has been converted to a standard body, OR to use the field flags for YAML forms. Note: For the gemini cli repository which uses YAML forms, you can often submit the content as a single body if a specific field based submission is not required by the automation. 6. Verify : Confirm the issue was created successfully and provide the link to the user. Principles Clarity : Titles should be descriptive and follow project conventions. Defensive Formatting : Always use temporary files with body file to prevent newline and special character issues. Maintainer Priority : Default to internal/maintainer labels to keep the backlog organized. Completeness : Provide all requested information (e.g., version info, reproduction steps).