name: gh-creating-issues description: Creates a new GitHub issue. Use when a new task, bug, or feature request needs to be tracked.

Creating GitHub Issues

Purpose

Enables the creation of new issues using the gh issue create command.

1. Safety & Verification

• Mandatory Context: Ensure gh-verifying-context has been run and confirmed by the user.
• Human-in-the-Loop: You MUST present the full command and the issue content (Title, Body) to the user before execution.
• Repository Check: Confirm the target repository name and owner with the user.
• Sensitivity Check: Do not include internal credentials, server IPs, or proprietary snippets in the issue body.

2. Common Workflows

Workflow: Create Basic Issue

Creates an issue with a title and body.

Command:

gh issue create --title "My Title" --body "My Description"

Workflow: Create with Labels, Assignees, and Projects

Sets metadata and links to a project board at creation time.

Command:

gh issue create --title "Bug Report" --body "Steps to repro..." --label "bug" --assignee "@me" --project "Roadmap"

Workflow: Create and Link as Sub-issue

Creates a new issue and immediately links it as a sub-issue to an existing parent.

Command:

# 1. Create the issue and get its numeric ID
NEW_ISSUE_ID=$(gh issue create --title "Sub-task" --body "Details..." --json id -q .id)

# 2. Link it to the parent
gh api --method POST /repos/{owner}/{repo}/issues/{parent_number}/sub_issues \
  -F sub_issue_id=$NEW_ISSUE_ID

3. Output Handling

Returns the URL of the created issue.