# Github Sub Issue Creator

> Creates GitHub sub-issues and links them to parent issues using gh CLI and REST API. Use when creating child issues, breaking down large issues into smaller tasks, or establishing parent-child relationships between issues.

- Skill: `majiayu000/github-sub-issue-creator` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/github-sub-issue-creator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/github-sub-issue-creator/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/github-sub-issue-creator

---


# GitHub Sub-issue Creator

This skill defines rules and procedures for creating GitHub sub-issues.

## Workflow

1. Identify the parent issue number and repository.
1. Create a new issue using the `github-issue-creator` skill.
1. Get the REST API ID of the created issue.
1. Add the issue as a sub-issue to the parent issue using the REST API.
1. Report the sub-issue URL to the user.

## Creating a Sub-issue

Sub-issues are regular issues linked to a parent issue. The gh CLI does not have a direct option to create sub-issues, so use the REST API via `gh api` command.

### Step 1: Create the Issue

Use the `github-issue-creator` skill to create the issue. This ensures that issue templates, title guidelines, and language settings are applied.

Note the issue number from the output URL (e.g., `https://github.com/OWNER/REPO/issues/123` → issue number is 123).

### Step 2: Get the Issue ID

Get the REST API ID of the created issue. This is the numeric `id` field, not the `node_id` or issue number.

```bash
gh api repos/OWNER/REPO/issues/123 --jq .id
```

### Step 3: Add as Sub-issue

Add the issue as a sub-issue to the parent issue.

```bash
gh api repos/OWNER/REPO/issues/PARENT_ISSUE_NUMBER/sub_issues -X POST -F sub_issue_id=ISSUE_ID
```

## Example

Creating a sub-issue for parent issue #100 in octocat/hello-world.

First, use the `github-issue-creator` skill to create an issue. Assume the created issue URL is `https://github.com/octocat/hello-world/issues/123`.

Then, get the issue ID and add as sub-issue:

```bash
# Get the issue ID
gh api repos/octocat/hello-world/issues/123 --jq .id
# Output: 3000028010

# Add as sub-issue
gh api repos/octocat/hello-world/issues/100/sub_issues -X POST -F sub_issue_id=3000028010
```

## Reference

For more details on the sub-issues API, see [REST API endpoints for sub-issues](https://docs.github.com/en/rest/issues/sub-issues).