Skip to content

GitHub Issues

Show GitHub issues with their associated PRs and branches, grouped by status (in progress vs. available), to help decide what to work on next.

When to use

Use this pattern when you need an overview of open work in a repository to decide what to work on next, review open issues and their linked PRs, or check merge readiness of open pull requests.

The pattern

Run the collocated script:

sh
node skills/github/issue-dashboard.js

Present the output directly — it is already formatted as markdown.

What the script does

  • Collects open issues, open PRs (with closingIssuesReferences), branches, and worktrees via gh CLI and git
  • Links PRs to issues via GitHub's closingIssuesReferences API field, falling back to "fixes/closes/resolves #N" regex on the PR body
  • Links PRs to issues via branch name pattern matching (issue number in branch)
  • Resolves UNKNOWN merge status via git merge-tree fallback
  • Queries unresolved review comment counts via GraphQL
  • Deduplicates local and remote branches

Output format

  • In Progress — issues with active branches or PRs, showing merge status, unresolved comment counts, and worktree paths
  • Available — issues with no branches or PRs, marked "Ready to work on"
  • Summary — total open issues/PRs, merge readiness counts, in progress vs available counts