skills.rest
MartinoPolo
MartinoPoloCOMMUNITY
Explore all skills by this author →
GitHub

mp-issue-create

Create GitHub issues with labels and optional PRD sub-issue links.

1|Updated Feb 7, 2026
Search Tags:#github#project planning#issue creation#label management#prd linking#hitl afk triage
One-click install
npx skills add https://github.com/MartinoPolo/mpx-claude-code --skill mp-issue-create
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mp-issue-create
Source: https://github.com/MartinoPolo/mpx-claude-code/tree/main/skills/mp-issue-create
Command: npx skills add https://github.com/MartinoPolo/mpx-claude-code --skill mp-issue-create

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the overhead of writing and structuring GitHub issues by generating a consistent issue body, labels, and optional PRD linkage from a short intent.

Core Features & Use Cases

  • Create canonical GitHub issues: Builds an issue using the repository’s shared issue template and includes a structured Requirements and optional Blocking Relationships section.
  • Optional PRD linking: Links a new sub-issue under a specific PRD number provided via --prd or auto-discovers the best open PRD by matching the issue summary.
  • HITL vs AFK classification: Determines whether the task is implementation-ready (AFK) or needs clarifying questions (HITL), and includes unanswered questions when needed.
  • Label management: Ensures required labels exist (task, HITL, AFK, design-needed, and area labels) and applies them to the created issue.

Quick Start

Ask to create a GitHub issue like: create github issue for improving authentication error handling, and link it to PRD 42.

Frequently Asked Questions about mp-issue-create

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

FAQPage Schema
How do I create well-structured GitHub issues from a short intent?▼

To create well-structured GitHub issues, provide an intent summary and the system builds the issue body using shared repository templates, applies required labels, and optionally links to an open PRD.

How does auto-discovery work when linking a new GitHub issue to a PRD?▼

PRD auto-discovery works by matching your issue summary against open PRDs to find the best fit, automatically linking the new issue as a sub-issue to that PRD without requiring an explicit PRD number.

What is the difference between HITL and AFK classification in issue creation?▼

HITL (Human-in-the-Loop) classification marks issues needing clarifying questions before implementation, while AFK (Away From Keyboard) marks tasks that are implementation-ready, adding unanswered questions to the issue body when needed.

How do I ensure required labels exist when creating a GitHub issue?▼

To ensure required labels exist, the issue creation process auto-generates missing task, HITL, AFK, design-needed, and area labels before applying them to the newly created GitHub issue.

Can I specify a PRD number manually when creating an issue?▼

Yes, you can manually specify a PRD number using the --prd flag to link the new sub-issue under a specific PRD, bypassing the automatic PRD discovery process entirely.

When do I need to use milestone selection for GitHub issue creation?▼

Milestone selection is applied only when a PRD is successfully resolved, either through explicit specification via the --prd flag or via automatic PRD discovery matching your intent summary.

Related Skills

Explore More Product & Management Skills→
J-StaR-Films-StudiosJ-StaR-Films-Studios
23

github-ops

Automate GitHub issue management, project board sync, and label creation via gh CLI.

Official
Intermediate
MartinoPoloMartinoPolo
1

mp-to-issues

Break a PRD GitHub issue into labeled vertical-slice sub-issues with blocking relationships.

Community
Advanced
joeczarjoeczar

milestone-tracker

Fetch GitHub milestones and issues to compute completion percentages.

Community
Intermediate
aryaxtaryaxt

create-issue

Create GitHub issues with automated summaries, labels, and codebase context.

Community
Advanced