| name | issue |
| description | Use when creating structured GitHub issues with explicit labels for criticality and implementation effort. |
| user_invocable | true |
GitHub Issue Creation Skill
Automates the creation of structured GitHub issues, ensuring required metadata labels for prioritization and implementation complexity are generated and applied.
Key Differences from Standard Creation
- Automated Labeling — Enforces classification of business value against technical complexity.
- Idempotent Setup — Verifies and creates necessary repository labels before issue instantiation.
- Structured Scoping — Collects defined metrics via interactive prompts to prevent poorly defined issues.
Workflow
Step 1: Detect repo info
REPO_NAME=$(git remote get-url origin | sed -E 's/.*[:\/]([^\/]+\/[^\/.]+)(\.git)?$/\1/')
Step 2: Define and Initialize Labels
The skill requires two taxonomies: Criticality (Impact) and Easiness (Effort).
| Label Category | Name | Color | Description |
|---|
| Criticality | criticality:high | b60205 | Blockers, severe regressions, or critical path items. |
| criticality:medium | e99695 | Important features or bugs with valid workarounds. |
| criticality:low | fef2c0 | Nice-to-haves, minor tweaks, or non-blocking debt. |
| Easiness | easiness:easy | 0e8a16 | Straightforward implementation, low risk, < 1 day. |
| easiness:medium | fbca04 | Moderate complexity, requires architecture review. |
| easiness:hard | d93f0b | High risk, complex dependencies, multi-day effort. |
Execute setup checks:
for label in "criticality:high" "criticality:medium" "criticality:low" "easiness:easy" "easiness:medium" "easiness:hard"; do
done
Step 3: Gather Issue Metadata via AskUserQuestion
Question: "What is the urgency of this issue?"
Header: "Urgency"
Options:
- label: "critical"
description: "Blockers or critical data integrity issues"
- label: "high"
description: "High priority features or major technical debt"
- label: "medium"
description: "Standard features, testing, and improvements"
- label: "low"
description: "Nice-to-haves and minor tweaks"
Question 2 — Easiness of Implementation:
Question: "How easy is this to implement?"
Header: "Easiness"
Options:
- label: "easy"
description: "Low effort, low risk, quick turnaround"
- label: "medium"
description: "Moderate complexity, standard development effort"
- label: "hard"
description: "High effort, high risk, or complex dependencies"
**Step 4: Input Title and Body**
* Prompt for issue title.
* Prompt for issue body (or use a predefined repository template).
**Step 5: Execute Issue Creation**
```bash
gh issue create \
--repo "$REPO_NAME" \
--title "$ISSUE_TITLE" \
--body "$ISSUE_BODY" \
--label "criticality:$CRITICALITY_SELECTION,easiness:$EASINESS_SELECTION"
Step 6: Confirm
Report execution metrics to the user:
- Issue Full URL / Number
- Applied Labels
- Assigned Milestones/Assignees (if applicable)