gh-issue-create
npx machina-cli add skill dceoy/github-cli-agent-skills/gh-issue-create --openclawFiles (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
- Verify auth:
gh --version gh auth status - Create the issue:
gh issue create --title "Bug: login fails" --body "Steps to reproduce..." gh issue create --label "bug" --assignee "@me" - 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 @meassigns yourself;@copilotis supported on GitHub.com only.- Adding to projects may require
gh auth refresh -s project.
References
- GitHub CLI manual: https://cli.github.com/manual/
gh issue create --help
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
- Step 1: Verify authentication and repo context with gh --version and gh auth status.
- Step 2: Create the issue with a title and body and any flags, e.g., gh issue create --title "..." --body "..." --label "..." --assignee "@me".
- 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