sub-issue
Manage GitHub sub-issues using the gh-sub-issue extension. Use when the user asks to create, list, add, or remove sub-issues (child issues) from a parent issue.
Install
npx skillscat add posit-dev/py-shiny/sub-issue Install via the SkillsCat registry.
SKILL.md
GitHub Sub-Issue Management
Manage GitHub sub-issues (child issues) using the gh sub-issue extension.
Prerequisites
Before using any sub-issue commands, check if the extension is installed:
gh extension list | grep -q sub-issue || gh extension install yahsan2/gh-sub-issueThis will install the extension if it's not already present.
Commands
Create a new sub-issue
Create a new issue directly linked as a child of a parent issue:
gh sub-issue create --parent <parent-issue> --title "<title>" --body "<body>" --repo posit-dev/connectFlags:
-p, --parent— Parent issue number or URL (required)-t, --title— Title for new sub-issue (required)-b, --body— Body text for the sub-issue-l, --label— Comma-separated labels-a, --assignee— Comma-separated usernames-m, --milestone— Milestone name or number--project— Projects (can specify multiple times)
Link an existing issue as a sub-issue
gh sub-issue add <parent-issue> <sub-issue> --repo posit-dev/connectList sub-issues of a parent
gh sub-issue list <parent-issue> --repo posit-dev/connect
gh sub-issue list <parent-issue> --state all --repo posit-dev/connectRemove a sub-issue link
gh sub-issue remove <parent-issue> <sub-issue> --repo posit-dev/connectUsage Notes
- Always include
--repo posit-dev/connectto ensure correct repository context - When creating multiple sub-issues, create them sequentially to avoid rate limiting
- Use
--bodywith heredoc for multi-line descriptions:
gh sub-issue create --parent 123 --title "My issue" --body "$(cat <<'EOF'
Description here.
**Acceptance criteria:**
1. First item
2. Second item
EOF
)" --repo posit-dev/connect- Reference the parent issue in the body for context (e.g., "Part of #123")
Install
npx skillscat add posit-dev/py-shiny/sub-issue Install via the SkillsCat registry.
Repository Stars
The star count shown is for the parent repository (posit-dev/py-shiny), not this specific skill.
.claude/skills/sub-issue