create-issue

Create Issue

Create GitHub issues cleanly by writing the body to a tmpfile and passing it via --body-file.

Why This Skill Exists

When creating GitHub issues, passing a large multiline --body string directly to gh issue create in a Bash command triggers Claude Code permission prompts because the command appears complex. This skill avoids that by using the Write tool to create a temporary file containing the issue body, then passing a short, simple gh issue create --body-file command to Bash.

Workflow

1. Gather Issue Details

Determine the issue title, body, labels, and assignees from the user's request. If the user's request is vague, ask clarifying questions. At minimum, you need:

• Title: A concise summary of the issue
• Body: A detailed description (can be multiple paragraphs, include code blocks, checklists, etc.)

Optional fields:

• Labels: Relevant labels (e.g., bug, enhancement, documentation)
• Assignees: GitHub usernames to assign
• Milestone: A milestone to associate with the issue
• Project: A GitHub project to add the issue to

2. Confirm the Repository

If the user specifies a repository (e.g., "file an issue on org/repo"), use the --repo flag. Otherwise, the issue will be created in the current repository.

3. Write the Issue Body to a Tmpfile

First, generate a unique temporary file path using mktemp:

mktemp /tmp/gh-issue-body-XXXXXX
# Returns a unique path, e.g.: /tmp/gh-issue-body-a1b2c3

Then use the Write tool to write the full issue body in Markdown format to the exact path returned by mktemp. In the examples below, TMPFILE is a placeholder for that path.

This is the critical step that avoids permission prompts: the Write tool handles multiline content natively, keeping the subsequent Bash command short and simple.

4. Create the Issue

Run a single, short gh issue create command using the tmpfile path from step 3:

gh issue create --title "Issue title here" --body-file TMPFILE