skills.rest
miyake-san
miyake-sanCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

github-issues

Create, update, and manage GitHub issues using MCP tools and the GitHub CLI.

Updated Aug 28, 2026
Search Tags:#project management#github#graphql#mcp#issues#gh cli#bug tracking
One-click install
npx skills add https://github.com/miyake-san/sogo-agent-platform --skill github-issues-miyake-san
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: github-issues
Source: https://github.com/miyake-san/sogo-agent-platform/tree/main/skills/core/github-issues
Command: npx skills add https://github.com/miyake-san/sogo-agent-platform --skill github-issues-miyake-san

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Managing GitHub issues through an AI agent requires knowing which operations the GitHub MCP server supports and which require the REST or GraphQL API. This Skill provides the exact commands, templates, and workflows for creating, updating, searching, and organizing issues without trial and error. ## Core Features & Use Cases - Issue Creation and Updates: Create bug reports, feature requests, and tasks via gh api with support for issue types, labels, assignees, and milestones, using structured body templates. - Advanced Organization: Manage sub-issues, blocked-by/blocking dependencies, custom issue fields (dates, priority), and Projects V2 boards through documented REST and GraphQL patterns. - Powerful Search: Query issues across repos with boolean logic, date ranges, and issue-field filters using MCP search tools or advanced search via gh api. - Use Case: A user asks to file a bug for a login crash. The Skill creates the issue with type=Bug, a structured body from the bug report template, and returns the issue URL. ## Quick Start Ask the agent to create a GitHub issue describing your bug or feature request, specifying the repository and any labels or priority you want set.

Frequently Asked Questions about github-issues

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

FAQPage Schema
How do I create a GitHub issue with the gh CLI?▼

Use `gh api repos/{owner}/{repo}/issues -X POST` with `-f title`, `-f body`, and optionally `-f type`, `-f labels[]`, and `-f assignees[]`. The `gh api` approach supports issue types, which `gh issue create` does not.

How do I set an issue type like Bug or Feature on GitHub?▼

Pass `-f type=Bug` in the `gh api` issue creation call, since issue types are only supported via the REST API, not the `gh issue create` CLI. Discover available org-level types with a GraphQL query on `organization.issueTypes`.

Can the GitHub MCP server create or update issues?▼

No, the GitHub MCP server currently only supports read operations like reading, listing, and searching issues. Creating, updating, and commenting on issues requires `gh api` REST calls or GraphQL mutations.

How do I add a sub-issue or mark an issue as blocked by another?▼

For sub-issues, POST to `/issues/{parent}/sub_issues` with the numeric issue ID sent as JSON via `--input`, since `-f` sends strings and causes a 422 error. For dependencies, use the `/dependencies/blocked_by` REST endpoint or the `addBlockedBy` GraphQL mutation.

Why does my GitHub project mutation fail with INSUFFICIENT_SCOPES?▼

The default `gh auth` token usually only has the `read:project` scope, which blocks write operations on Projects V2. Run `gh auth refresh -h github.com -s project` and complete the browser OAuth flow to add the write scope.

Why do images uploaded via the GitHub API not render in private repos?▼

URLs from `raw.githubusercontent.com` return 404 for private repos because the CDN does not pass auth headers. Use the `github.com/{owner}/{repo}/raw/{branch}/{path}` format instead, or upload via the browser to get a public `user-attachments` URL.

Related Skills

Explore More Software Engineering Skills→
aws-samplesaws-samples
186

github

Manage GitHub issues, pull requests, branches, and repository metadata via OAuth.

Official
Intermediate
d0d012d0d012
9

jira-tool

Create, update, transition, and query Jira issues via API.

Community
Advanced
DonZzzillaDonZzzilla

github-repo-management

Manage GitHub repositories, pull requests, issues, and Pages deployments.

Community
Advanced
seb1nseb1n
147

Project Management

Decompose work into tasks and track progress across sprints.

Community
Advanced