How does this skill handle issue hierarchies?

It utilizes GitHub's native sub-issues feature (GA April 2025), which allows for nesting tasks up to 8 levels deep with automatic progress tracking in the parent issue body.

Is GitHub Projects v2 required for this workflow?

No, Projects v2 is treated as an optional visualization layer. The workflow is designed so that all critical content, history, and status live within the Issues themselves.

Can I use this for multiple repositories at once?

Yes, the skill provides specific workflows for creating cross-repo dashboards and linking issues from multiple repositories into a single visualization board.

What is the benefit of using sub-issues over tasklists?

Sub-issues provide a more robust structure with their own status, assignees, and history, replacing the legacy tasklist blocks which were retired in 2025.

Does this skill require special permissions?

To manage Projects v2 via the CLI, you must use a GitHub Classic Personal Access Token (PAT) with the 'project' scope, as fine-grained tokens may have limited support.

GitHub Issues & Sub-issues Workflow

Name: GitHub Issues & Sub-issues Workflow
Author: terrylica

byterrylica

•

协作工具

Streamlines GitHub project management using native sub-issue hierarchies, label-driven status tracking, and optional Project v2 visualizations.

This skill implements a robust 'Issues-First' workflow, leveraging GitHub's native sub-issue capabilities to manage complex task hierarchies directly within your repository. It prioritizes Issues as the single source of truth for content, history, and status, while utilizing Projects v2 primarily as a visualization layer for Kanban and roadmap views. By automating the creation of nested issues and standardized label sets, it helps developers and researchers maintain structured progress tracking, epic decomposition, and cross-repo visibility without leaving the command line.

主要功能

0114 GitHub stars

02Advanced issue filtering and multi-repository search patterns

03Automated label-based status, priority, and research tracking

04Native sub-issue hierarchy creation (up to 8 levels deep)

05Cross-repo dashboard synchronization using Projects v2

06Stakeholder status updates and progress reporting via CLI

使用场景

01Decomposing large product epics into actionable sub-tasks with automatic progress bars

02Structuring deep-dive research into validated and invalidated hypotheses using sub-issues

03Setting up unified cross-repository visualization dashboards for multi-project management

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add terrylica/cc-skills issues-workflow

For use in Claude.ai and ChatGPT

Download Skill