OpenParable
Skip to content
← Back to skills

Sub Issue

Productivity
sub-issue

Sub Issue is an Agent Skill for productivity published in the posit-dev/py-shiny repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/posit-dev/py-shiny/blob/HEAD/.claude/skills/sub-issue/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/sub-issue, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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-issue

This 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/connect

Flags:

  • -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/connect

List 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/connect

Remove a sub-issue link

gh sub-issue remove <parent-issue> <sub-issue> --repo posit-dev/connect

Usage Notes

  1. Always include --repo posit-dev/connect to ensure correct repository context
  2. When creating multiple sub-issues, create them sequentially to avoid rate limiting
  3. Use --body with 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
  1. Reference the parent issue in the body for context (e.g., "Part of #123")