Skip to content

espennilsen/pi / skills/github

Interact with GitHub repos, PRs, issues, CI, and notifications via the pi-github extension commands and gh CLI. Use when asked to check PRs, list issues, view repo status, check CI, browse notifications, create or merge PRs, fix PR review feedback, or perform any GitHub operation. **Triggers:** "open PRs", "repo status", "CI status", "merge PR", "fix PR", "fix PRs", "fix review feedback", "create PR", "GitHub notifications", any /gh-* command, or when a GitHub PR URL is shared.

GitHub — pi-github Extension

The pi-github extension provides /gh-* commands for common GitHub operations. All commands also work as /github-* variants.

Prerequisites

  • gh CLI installed and authenticated
  • For repo-scoped commands: run from a git repo, or specify the repo

Commands + Agent Tools

The pi-github extension provides /gh-* commands for user-initiated operations and LLM tools for agentic workflows (PR review thread resolution).

Commands

CommandWhat it does
/gh-prs [mine|review-requested] [repo]List open PRs
/gh-issues [mine|label:name] [repo]List open issues
/gh-status [repo]Repo dashboard: PRs, issues, CI, branch PR
/gh-actions [branch] [repo]Recent workflow runs
/gh-notificationsUnread GitHub notifications
/gh-pr-create [base]Create PR with LLM-generated summary
/gh-pr-review [number|repo#N|URL]Show PR review feedback
/gh-pr-fix [number|repo#N|URL]Fix unresolved review threads
/gh-pr-merge [number|repo#N|URL] [--squash|--merge|--rebase]Merge PR + full cleanup

PR Thread Tools (for agents fixing review feedback)

These tools use gh CLI under the hood — no API tokens needed. Always prefer these over raw REST/GraphQL calls.

ToolPurpose
github_review_thread_replyReply to a PR review thread (thread_id, message)
github_resolve_review_threadMark a review thread as resolved (thread_id) — MANDATORY after each fix
github_post_pr_commentPost a summary comment on a PR (owner, repo, pr_number, body)

Repo Reference Syntax

Commands accept flexible repo/PR references anywhere in args:

FormatExample
GitHub URLhttps://github.com/owner/repo/pull/123
Owner/repo#Nespennilsen/pi#96
Repo#N (with default owner)pi#96
Owner/repoespennilsen/pi
Plain number96
No argsAuto-detect from current branch

Default Owner

Set in settings.json to skip typing the owner:

{ "pi-github": { "defaultOwner": "espennilsen" } }

Detailed Workflows

For complex PR operations, see the reference docs:

  • Fixing PR review threads — references/pr-fix.md Read when fixing unresolved review feedback, resolving threads, or using /gh-pr-fix. ⚠️ Mandatory: after pushing code fixes, resolve ALL threads via GraphQL resolveReviewThread.

  • Parallel PR fixes — references/pr-fix-parallel.md Read when fixing review feedback across multiple PRs simultaneously using parallel subagents (pool or orchestrator mode).

  • Merging PRs — references/pr-merge.md Read when merging a PR, resolving merge conflicts, cleaning up branches/worktrees, or using /gh-pr-merge.

  • Creating PRs — references/pr-create.md Read when creating a PR with a generated summary, or using /gh-pr-create.

Raw gh CLI

For anything the commands don't cover:

# Structured output
gh pr list --json number,title --jq '.[] | "#\(.number) \(.title)"'

# GraphQL
gh api graphql -f query='{ viewer { login } }'

# API calls
gh api repos/owner/repo/contributors --jq '.[].login'

Conventions

  • Default merge strategy: squash
  • Tag releases as v<semver>
  • Use --json + --jq for structured output
  • Always use worktrees for feature branches — never git checkout in main dir
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 318kUpdated Claude CodeCodexUnverifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 318kUpdated Claude CodeCodexUnverifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 318kUpdated Claude CodeCodexUnverifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 318kUpdated Claude CodeCodexUnverifiedInstall