gum-issue-creation

Creates well-structured GitHub issues for the Gum repository using the gh CLI.

614|78|Updated Mar 11, 2015
One-click install
npx skills add https://github.com/vchelaru/Gum --skill gum-issue-creation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gum-issue-creation
Source: https://github.com/vchelaru/Gum/tree/main/.claude/skills/gum-issue-creation
Command: npx skills add https://github.com/vchelaru/Gum --skill gum-issue-creation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Filing GitHub issues that are vague, mislabeled, or poorly formatted wastes maintainer time and delays fixes. This Skill enforces the Gum repository's conventions so every issue you file is specific, labeled correctly, and actionable for whoever picks it up.

Core Features & Use Cases

  • Convention-enforced issue creation: Uses gh issue create with the correct bug label applied at creation time, plus rules for when not to file (e.g., Sokol feature-parity gaps are not tracked).
  • Structured issue bodies: Enforces a scannable body format with Problem, Suggested improvement, Source (file:line pointers), and Reach sections so a future implementer can act immediately.
  • Shell-correct multi-line bodies: Provides PowerShell here-string and Bash heredoc/--body-file patterns so GitHub Markdown renders real line breaks instead of literal \n sequences.
  • Use Case: You notice the Animation tab shows a confusing "Could not find state or animation" error. The Skill greps for the source pointer, drafts a titled issue with the error location and reach analysis, applies the bug label, and reports back the issue URL.

Quick Start

Ask the assistant to log a GitHub issue in the Gum repo describing the problem you just observed, including where in the source it occurs.

Frequently Asked Questions about gum-issue-creation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a GitHub issue from the command line?

Use gh issue create with a title, body, and labels. For multi-line bodies, use a PowerShell here-string or a Bash heredoc or --body-file so GitHub renders real line breaks instead of literal \n sequences.

How should a good bug report issue be structured?

Structure the body with a Problem section describing what is wrong, a Source section with file:line pointers found by grepping, and a Reach section explaining how users hit the broken path. Add a Suggested improvement section when a concrete target behavior exists.

Why do literal \n characters appear in my GitHub issue body?

Literal \n sequences appear when the shell string is not a real multi-line value, since GitHub Markdown does not convert them into line breaks. Use a PowerShell here-string, a Bash heredoc, or gh's --body-file flag, then verify with gh issue view --json body.

When should I not file a GitHub issue for the Gum project?

Do not file issues for Sokol feature-parity gaps, since SokolGum is not held to per-backend parity with MonoGame, raylib, or Skia. Also avoid filing raw diagnostic observations that no user would ever see.

How do I add labels when creating a GitHub issue with gh?

Pass --label bug to gh issue create at creation time so the label applies immediately. In the Gum repo the bug label exists and should be applied to all bug reports without second-guessing.