skills.rest
posit-dev
posit-devOFFICIAL
Explore all skills by this author →
GitHub

sub-issue

Manage GitHub sub-issues using native gh CLI commands.

1.8k|134|Updated Jul 27, 2021
Search Tags:#parent issue#gh CLI#sub-issues#gitHub#Project management#Issue tracking
One-click install
npx skills add https://github.com/posit-dev/py-shiny --skill sub-issue
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sub-issue
Source: https://github.com/posit-dev/py-shiny/tree/main/.claude/skills/sub-issue
Command: npx skills add https://github.com/posit-dev/py-shiny --skill sub-issue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Breaking large GitHub issues into smaller child issues and tracking their hierarchy requires manual linking, which is error-prone and tedious without dedicated tooling.

Core Features & Use Cases

  • Create Sub-Issues: Create new issues directly linked as children of a parent issue using gh issue create --parent.
  • Link and Unlink Issues: Add existing issues as sub-issues, change parents, or remove sub-issue relationships with gh issue edit.
  • List Sub-Issues: View all child issues and summary counts of a parent via gh issue view --json subIssues,subIssuesSummary.
  • Use Case: When planning a large feature in posit-dev/py-shiny, create a parent tracking issue and spawn multiple sub-issues for each work item, keeping the hierarchy visible in GitHub.

Quick Start

Ask the agent to create a sub-issue titled "Add input validation" under parent issue 123 in the posit-dev/py-shiny repository.

Frequently Asked Questions about sub-issue

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

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

Run gh issue create with the --parent flag followed by the parent issue number, plus --title and --body. For example: gh issue create --parent 123 --title "My task" --repo posit-dev/py-shiny.

How do I add an existing issue as a sub-issue?▼

Use gh issue edit on the parent issue with the --add-sub-issue flag followed by the child issue number. Alternatively, run gh issue edit on the child with --parent to set its parent directly.

What gh CLI version supports sub-issues?▼

Native sub-issue flags require gh CLI version 2.94.0 or newer. Check your version with gh --version; older versions lack --parent, --add-sub-issue, --remove-sub-issue, and --remove-parent.

How do I list all sub-issues of a GitHub issue?▼

Run gh issue view with the parent issue number and request the subIssues and subIssuesSummary JSON fields. This returns the child issues and a summary of their completion status.

How do I remove a sub-issue from a parent issue?▼

Use gh issue edit on the parent with --remove-sub-issue and the child issue number to unlink it. To detach a child from its parent entirely, edit the child issue with the --remove-parent flag.

Related Skills

Explore More Software Engineering Skills→
typemdtypemd
9

create-issue

Guide brainstorming and draft GitHub issues with acceptance criteria.

Official
Advanced
deneb-labdeneb-lab

end-implementing-issue

Close GitHub issues and update project boards with end dates.

Official
Advanced
sangrokjungsangrokjung
1

release-note-generation

Generate PowerToys release notes from merged GitHub Pull Requests.

Community
Advanced
cwijayasundaracwijayasundara
3

tracker-publish

Publish Claude Harness dependency groups to Linear/Jira tracker tasks.

Community
Advanced