Get the FREE Ultimate OpenClaw Setup Guide →

gh-issue-create

npx machina-cli add skill dceoy/github-cli-agent-skills/gh-issue-create --openclaw
Files (1)
SKILL.md
1.3 KB

GitHub Issue Create

When to use

  • The user asks to open a new issue.
  • You need to file a bug, feature request, or task.

Inputs to confirm

  • Title and body.
  • Labels, assignees, milestone, project (optional).
  • Target repo if not current (--repo OWNER/REPO).

Workflow

  1. Verify auth:
    gh --version
    gh auth status
    
  2. Create the issue:
    gh issue create --title "Bug: login fails" --body "Steps to reproduce..."
    gh issue create --label "bug" --assignee "@me"
    
  3. Optional: use templates or open the web flow:
    gh issue create --template "Bug Report"
    gh issue create --web
    

Examples

# Create with labels and assignee
~ gh issue create --title "Add caching" --body "Details..." --label "performance" --assignee "@me"

Notes

  • --assignee @me assigns yourself; @copilot is supported on GitHub.com only.
  • Adding to projects may require gh auth refresh -s project.

References

Source

git clone https://github.com/dceoy/github-cli-agent-skills/blob/main/skills/gh-issue-create/SKILL.mdView on GitHub

Overview

gh-issue-create lets you file new GitHub issues from the command line using the gh tool, including labels, assignees, milestones, and projects. It supports templates and a web flow for faster intake and consistency across repositories.

How This Skill Works

Confirm the issue title and body, then apply optional flags for labels, assignees, milestone, and project when running gh issue create. Typical usage starts with authentication checks (gh --version and gh auth status) and then creates the issue with commands like gh issue create --title "..." --body "..." [flags], with optional --template or --web if desired.

When to Use It

  • The user asks to open a new issue.
  • You need to file a bug, feature request, or task.
  • You want to add labels, assignees, a milestone, or a project to the new issue.
  • You need to target a specific repository with --repo OWNER/REPO.
  • You want to speed up intake using a template or the web flow (--template or --web).

Quick Start

  1. Step 1: Verify authentication and repo context with gh --version and gh auth status.
  2. Step 2: Create the issue with a title and body and any flags, e.g., gh issue create --title "..." --body "..." --label "..." --assignee "@me".
  3. Step 3: Optional: use a template or open the web flow with --template "Bug Report" or --web.

Best Practices

  • Start with a concise, descriptive title.
  • Provide a clear body with steps to reproduce or acceptance criteria.
  • Use labels consistently and assign the right owners.
  • Specify a milestone when it helps track progress.
  • Leverage --template or --web for faster, standardized creation.

Example Use Cases

  • gh issue create --title "Add caching" --body "Details..." --label "performance" --assignee "@me"
  • gh issue create --title "Bug: login fails" --body "Steps to reproduce..." --label "bug" --assignee "@john" --milestone "v1.2"
  • gh issue create --title "Add dark mode" --body "User request..." --template "Feature Request"
  • gh issue create --title "Improve docs" --body "Clarifications..." --web
  • gh issue create --title "Add CI job for PRs" --body "Configure GH Actions..." --repo octo-org/portal --label "ci" --milestone "Next"

Frequently Asked Questions

Add this skill to your agents
Sponsor this space

Reach thousands of developers