GH PR Check

Overview

Check PR status for the current branch with gh and report a recommended next action, using REST-first pull-request lookups instead of gh pr list as the primary path.

This skill is check-only:

Do not create/switch branches
Do not push
Do not create/edit PRs

Decision rules (must follow)

Resolve repository, head branch, and base branch.
- head: current branch (git rev-parse --abbrev-ref HEAD)
- base: default develop unless user specifies
Optionally collect local working tree state:
- git status --porcelain
- Report as context only; do not mutate files.
Fetch latest remote refs before comparing:
- git fetch origin
List PRs for head branch:
- Resolve repo slug: gh repo view --json nameWithOwner -q .nameWithOwner
- Resolve owner from <owner>/<repo>
- Primary lookup path:
  - gh api repos/<owner>/<repo>/pulls?state=all&head=<owner>:<head>&per_page=100
Classify:
- No PR found -> NO_PR + recommended action CREATE_PR
- Any PR where mergedAt == null -> UNMERGED_PR_EXISTS + recommended action PUSH_ONLY
- All PRs merged -> perform post-merge commit check
Post-merge commit check (critical when all PRs are merged):
- Select latest merged PR by mergedAt
- Get merge commit SHA from mergeCommit.oid
- Verify merge commit ancestry before counting:
  - git merge-base --is-ancestor <merge_commit> HEAD
- If merge commit is ancestor of HEAD, count commits after merge:
  - git rev-list --count <merge_commit>..HEAD
- If count > 0 -> ALL_MERGED_WITH_NEW_COMMITS + CREATE_PR
- If count == 0 -> ALL_MERGED_NO_NEW_COMMITS + NO_ACTION
Fallback when merge commit SHA is missing or not an ancestor of HEAD:
- First compare against branch upstream (preferred):
  - git rev-list --count origin/<head>..HEAD
- Count > 0 -> ALL_MERGED_WITH_NEW_COMMITS + CREATE_PR (fallback)
- If upstream count is 0, still compare against base:
  - git rev-list --count origin/<base>..HEAD
- Base count > 0 -> ALL_MERGED_WITH_NEW_COMMITS + CREATE_PR (fallback)
- Base count == 0 -> ALL_MERGED_NO_NEW_COMMITS + NO_ACTION
- If both comparisons fail -> CHECK_FAILED + MANUAL_CHECK

Output contract

Return a human-readable summary by default.

Do not return raw JSON as the default output. If JSON is explicitly requested by the user, append it after the human summary.

Recommended status values:

NO_PR
UNMERGED_PR_EXISTS
ALL_MERGED_WITH_NEW_COMMITS
ALL_MERGED_NO_NEW_COMMITS
CHECK_FAILED

Recommended action values:

CREATE_PR
PUSH_ONLY
NO_ACTION
MANUAL_CHECK

Language rule

Follow the user's input language for all headings and messages.
If the language is ambiguous, use English.

Default output template

Output 1-3 lines using a signal prefix + action keyword on line 1.

| Prefix | Action | Meaning | | --- | --- | --- | | >> | CREATE PR | Create a new PR | | > | PUSH ONLY | Push to existing PR | | -- | NO ACTION | Nothing to do | | !! | MANUAL CHECK | Manual check required |

Per-status format:

NO_PR: >> CREATE PR — No PR exists for <head> -> <base>.

UNMERGED_PR_EXISTS (2 lines):

> PUSH ONLY — Unmerged PR open for `<head>`.
   PR: #<number> <url>

ALL_MERGED_WITH_NEW_COMMITS (2 lines):

>> CREATE PR — <N> new commit(s) after last merge (#<pr_number>).
   head: <head> -> base: <base>

ALL_MERGED_NO_NEW_COMMITS: -- NO ACTION — All PRs merged, no new commits on <head>.

CHECK_FAILED (2 lines):

!! MANUAL CHECK — Could not determine PR status.
   Reason: <reason>
   head: <head> -> base: <base>

Append the following line only when the worktree is dirty:

   (!) Worktree has uncommitted changes.

Status-to-action mapping (must use)

| Status | Prefix | Action | Template | | --- | --- | --- | --- | | NO_PR | >> | CREATE PR | No PR exists | | UNMERGED_PR_EXISTS | > | PUSH ONLY | Unmerged PR open | | ALL_MERGED_WITH_NEW_COMMITS | >> | CREATE PR | N new commit(s) | | ALL_MERGED_NO_NEW_COMMITS | -- | NO ACTION | All PRs merged | | CHECK_FAILED | !! | MANUAL CHECK | Could not determine |

Example outputs

NO_PR:

>> CREATE PR — No PR exists for `feature/my-branch` -> `develop`.

UNMERGED_PR_EXISTS:

> PUSH ONLY — Unmerged PR open for `feature/my-branch`.
   PR: #456 https://github.com/org/repo/pull/456

ALL_MERGED_WITH_NEW_COMMITS:

>> CREATE PR — 3 new commit(s) after last merge (#123).
   head: feature/my-branch -> base: develop

ALL_MERGED_NO_NEW_COMMITS:

-- NO ACTION — All PRs merged, no new commits on `feature/my-branch`.

CHECK_FAILED:

!! MANUAL CHECK — Could not determine PR status.
   Reason: Could not resolve merge commit and fallback comparison failed
   head: feature/my-branch -> base: develop

With dirty worktree (appended to any status):

>> CREATE PR — 3 new commit(s) after last merge (#123).
   head: feature/my-branch -> base: develop
   (!) Worktree has uncommitted changes.

Workflow (recommended)

Verify repo context:
- git rev-parse --show-toplevel
- git rev-parse --abbrev-ref HEAD
Confirm auth:
- gh auth status
- If GH_TOKEN / GITHUB_TOKEN is already set for REST calls, do not treat gh auth status as the sole readiness gate.
Collect context:
- git status --porcelain
- git fetch origin
Prefer the REST pull-request list endpoint over gh pr list when checking branch PR state.
List PRs for head branch and classify using rules above.
When all PRs are merged, validate merge commit ancestry before counting commits.
If merge commit is not usable, fallback to origin/<head>..HEAD first and then origin/<base>..HEAD before returning NO_ACTION.
Print human-readable result using the default template.
Append JSON only if the user explicitly asks for machine-readable output.

Quick start

# Human-readable output
python3 "${CLAUDE_PLUGIN_ROOT}/skills/gwt-pr-check/scripts/check_pr_status.py" --repo "."

# Explicit base branch
python3 "${CLAUDE_PLUGIN_ROOT}/skills/gwt-pr-check/scripts/check_pr_status.py" --repo "." --base develop

# Append machine-readable JSON after the summary
python3 "${CLAUDE_PLUGIN_ROOT}/skills/gwt-pr-check/scripts/check_pr_status.py" --repo "." --json

Command snippet (bash)

head="${HEAD_BRANCH:-$(git rev-parse --abbrev-ref HEAD)}"
base="${BASE_BRANCH:-develop}"

dirty=0
if [ -n "$(git status --porcelain)" ]; then
  dirty=1
fi

git fetch origin

repo_slug="$(gh repo view --json nameWithOwner -q .nameWithOwner)"
owner="${repo_slug%%/*}"
pr_json="$(gh api "repos/$repo_slug/pulls?state=all&head=$owner:$head&per_page=100")"
pr_count="$(echo "$pr_json" | jq 'length')"
unmerged_count="$(echo "$pr_json" | jq 'map(select(.merged_at == null)) | length')"

if [ "$pr_count" -eq 0 ]; then
  status="NO_PR"
  action="CREATE_PR"
  reason="No PR found for head branch"
elif [ "$unmerged_count" -gt 0 ]; then
  status="UNMERGED_PR_EXISTS"
  action="PUSH_ONLY"
  reason="At least one PR for the head branch is not merged"
else
  merge_commit="$(echo "$pr_json" | jq -r 'map(select(.merged_at != null)) | sort_by(.updated_at) | last | .merge_commit_sha')"
  merge_commit_ancestor=0
  if [ -n "$merge_commit" ] && [ "$merge_commit" != "null" ] && \
     git merge-base --is-ancestor "$merge_commit" HEAD 2>/dev/null; then
    merge_commit_ancestor=1
    new_commits="$(
      git rev-list --count "$merge_commit"..HEAD 2>/dev/null || echo ""
    )"
  else
    new_commits=""
  fi

  if [ -n "$new_commits" ]; then
    if [ "$new_commits" -gt 0 ]; then
      status="ALL_MERGED_WITH_NEW_COMMITS"
      action="CREATE_PR"
      reason="$new_commits commits found after last merge"
    else
      status="ALL_MERGED_NO_NEW_COMMITS"
      action="NO_ACTION"
      reason="No commits found after last merge"
    fi
  else
    upstream_commits="$(
      git rev-list --count "origin/$head"..HEAD 2>/dev/null || echo ""
    )"
    fallback_commits="$(
      git rev-list --count "origin/$base"..HEAD 2>/dev/null || echo ""
    )"

    if [ -n "$upstream_commits" ] && [ "$upstream_commits" -gt 0 ]; then
      status="ALL_MERGED_WITH_NEW_COMMITS"
      action="CREATE_PR"
      reason="Fallback check found commits ahead of origin/$head"
    elif [ -n "$fallback_commits" ]; then
      if [ "$fallback_commits" -gt 0 ]; then
        status="ALL_MERGED_WITH_NEW_COMMITS"
        action="CREATE_PR"
        reason="Fallback check found commits ahead of origin/$base"
      else
        status="ALL_MERGED_NO_NEW_COMMITS"
        action="NO_ACTION"
        reason="Fallback check found no commits ahead of origin/$head or origin/$base"
      fi
    else
      status="CHECK_FAILED"
      action="MANUAL_CHECK"
      reason="Could not resolve merge commit and fallback comparison failed"
    fi
  fi
fi

latest_merged_pr="$(
  echo "$pr_json" \
    | jq -r 'map(select(.merged_at != null)) | sort_by(.updated_at) | last | .number // empty'
)"
unmerged_pr="$(
  echo "$pr_json" \
    | jq -r 'map(select(.merged_at == null)) | first | .number // empty'
)"
unmerged_pr_url="$(
  echo "$pr_json" \
    | jq -r 'map(select(.merged_at == null)) | first | .html_url // empty'
)"

case "$status" in
  NO_PR)
    echo ">> CREATE PR — No PR exists for \`$head\` -> \`$base\`."
    ;;
  UNMERGED_PR_EXISTS)
    echo "> PUSH ONLY — Unmerged PR open for \`$head\`."
    echo "   PR: #$unmerged_pr $unmerged_pr_url"
    ;;
  ALL_MERGED_WITH_NEW_COMMITS)
    n="${new_commits:-$upstream_commits}"
    echo ">> CREATE PR — $n new commit(s) after last merge (#$latest_merged_pr)."
    echo "   head: $head -> base: $base"
    ;;
  ALL_MERGED_NO_NEW_COMMITS)
    echo "-- NO ACTION — All PRs merged, no new commits on \`$head\`."
    ;;
  *)
    echo "!! MANUAL CHECK — Could not determine PR status."
    echo "   Reason: $reason"
    echo "   head: $head -> base: $base"
    ;;
esac

if [ "$dirty" -eq 1 ]; then
  echo "   (!) Worktree has uncommitted changes."
fi

Related skill

gwt-pr: creates/updates PRs
gwt-pr-fix: diagnoses and fixes failing PRs

GH PR Check

Overview

Check PR status for the current branch with gh and report a recommended next action, using REST-first pull-request lookups instead of gh pr list as the primary path.

This skill is check-only:

Do not create/switch branches
Do not push
Do not create/edit PRs

Decision rules (must follow)

Resolve repository, head branch, and base branch.
- head: current branch (git rev-parse --abbrev-ref HEAD)
- base: default develop unless user specifies
Optionally collect local working tree state:
- git status --porcelain
- Report as context only; do not mutate files.
Fetch latest remote refs before comparing:
- git fetch origin
List PRs for head branch:
- Resolve repo slug: gh repo view --json nameWithOwner -q .nameWithOwner
- Resolve owner from <owner>/<repo>
- Primary lookup path:
  - gh api repos/<owner>/<repo>/pulls?state=all&head=<owner>:<head>&per_page=100
Classify:
- No PR found -> NO_PR + recommended action CREATE_PR
- Any PR where mergedAt == null -> UNMERGED_PR_EXISTS + recommended action PUSH_ONLY
- All PRs merged -> perform post-merge commit check
Post-merge commit check (critical when all PRs are merged):
- Select latest merged PR by mergedAt
- Get merge commit SHA from mergeCommit.oid
- Verify merge commit ancestry before counting:
  - git merge-base --is-ancestor <merge_commit> HEAD
- If merge commit is ancestor of HEAD, count commits after merge:
  - git rev-list --count <merge_commit>..HEAD
- If count > 0 -> ALL_MERGED_WITH_NEW_COMMITS + CREATE_PR
- If count == 0 -> ALL_MERGED_NO_NEW_COMMITS + NO_ACTION
Fallback when merge commit SHA is missing or not an ancestor of HEAD:
- First compare against branch upstream (preferred):
  - git rev-list --count origin/<head>..HEAD
- Count > 0 -> ALL_MERGED_WITH_NEW_COMMITS + CREATE_PR (fallback)
- If upstream count is 0, still compare against base:
  - git rev-list --count origin/<base>..HEAD
- Base count > 0 -> ALL_MERGED_WITH_NEW_COMMITS + CREATE_PR (fallback)
- Base count == 0 -> ALL_MERGED_NO_NEW_COMMITS + NO_ACTION
- If both comparisons fail -> CHECK_FAILED + MANUAL_CHECK

Output contract

Return a human-readable summary by default.

Do not return raw JSON as the default output. If JSON is explicitly requested by the user, append it after the human summary.

Recommended status values:

NO_PR
UNMERGED_PR_EXISTS
ALL_MERGED_WITH_NEW_COMMITS
ALL_MERGED_NO_NEW_COMMITS
CHECK_FAILED

Recommended action values:

CREATE_PR
PUSH_ONLY
NO_ACTION
MANUAL_CHECK

Language rule

Follow the user's input language for all headings and messages.
If the language is ambiguous, use English.

Default output template

Output 1-3 lines using a signal prefix + action keyword on line 1.

Per-status format:

NO_PR: >> CREATE PR — No PR exists for <head> -> <base>.

UNMERGED_PR_EXISTS (2 lines):

> PUSH ONLY — Unmerged PR open for `<head>`.
   PR: #<number> <url>

ALL_MERGED_WITH_NEW_COMMITS (2 lines):

>> CREATE PR — <N> new commit(s) after last merge (#<pr_number>).
   head: <head> -> base: <base>

ALL_MERGED_NO_NEW_COMMITS: -- NO ACTION — All PRs merged, no new commits on <head>.

CHECK_FAILED (2 lines):

!! MANUAL CHECK — Could not determine PR status.
   Reason: <reason>
   head: <head> -> base: <base>

Append the following line only when the worktree is dirty:

   (!) Worktree has uncommitted changes.

Status-to-action mapping (must use)

Example outputs

NO_PR:

>> CREATE PR — No PR exists for `feature/my-branch` -> `develop`.

UNMERGED_PR_EXISTS:

> PUSH ONLY — Unmerged PR open for `feature/my-branch`.
   PR: #456 https://github.com/org/repo/pull/456

ALL_MERGED_WITH_NEW_COMMITS:

>> CREATE PR — 3 new commit(s) after last merge (#123).
   head: feature/my-branch -> base: develop

ALL_MERGED_NO_NEW_COMMITS:

-- NO ACTION — All PRs merged, no new commits on `feature/my-branch`.

CHECK_FAILED:

!! MANUAL CHECK — Could not determine PR status.
   Reason: Could not resolve merge commit and fallback comparison failed
   head: feature/my-branch -> base: develop

With dirty worktree (appended to any status):

>> CREATE PR — 3 new commit(s) after last merge (#123).
   head: feature/my-branch -> base: develop
   (!) Worktree has uncommitted changes.

Workflow (recommended)

Verify repo context:
- git rev-parse --show-toplevel
- git rev-parse --abbrev-ref HEAD
Confirm auth:
- gh auth status
- If GH_TOKEN / GITHUB_TOKEN is already set for REST calls, do not treat gh auth status as the sole readiness gate.
Collect context:
- git status --porcelain
- git fetch origin
Prefer the REST pull-request list endpoint over gh pr list when checking branch PR state.
List PRs for head branch and classify using rules above.
When all PRs are merged, validate merge commit ancestry before counting commits.
If merge commit is not usable, fallback to origin/<head>..HEAD first and then origin/<base>..HEAD before returning NO_ACTION.
Print human-readable result using the default template.
Append JSON only if the user explicitly asks for machine-readable output.

Quick start

# Human-readable output
python3 "${CLAUDE_PLUGIN_ROOT}/skills/gwt-pr-check/scripts/check_pr_status.py" --repo "."

# Explicit base branch
python3 "${CLAUDE_PLUGIN_ROOT}/skills/gwt-pr-check/scripts/check_pr_status.py" --repo "." --base develop

# Append machine-readable JSON after the summary
python3 "${CLAUDE_PLUGIN_ROOT}/skills/gwt-pr-check/scripts/check_pr_status.py" --repo "." --json

Command snippet (bash)

head="${HEAD_BRANCH:-$(git rev-parse --abbrev-ref HEAD)}"
base="${BASE_BRANCH:-develop}"

dirty=0
if [ -n "$(git status --porcelain)" ]; then
  dirty=1
fi

git fetch origin

repo_slug="$(gh repo view --json nameWithOwner -q .nameWithOwner)"
owner="${repo_slug%%/*}"
pr_json="$(gh api "repos/$repo_slug/pulls?state=all&head=$owner:$head&per_page=100")"
pr_count="$(echo "$pr_json" | jq 'length')"
unmerged_count="$(echo "$pr_json" | jq 'map(select(.merged_at == null)) | length')"

if [ "$pr_count" -eq 0 ]; then
  status="NO_PR"
  action="CREATE_PR"
  reason="No PR found for head branch"
elif [ "$unmerged_count" -gt 0 ]; then
  status="UNMERGED_PR_EXISTS"
  action="PUSH_ONLY"
  reason="At least one PR for the head branch is not merged"
else
  merge_commit="$(echo "$pr_json" | jq -r 'map(select(.merged_at != null)) | sort_by(.updated_at) | last | .merge_commit_sha')"
  merge_commit_ancestor=0
  if [ -n "$merge_commit" ] && [ "$merge_commit" != "null" ] && \
     git merge-base --is-ancestor "$merge_commit" HEAD 2>/dev/null; then
    merge_commit_ancestor=1
    new_commits="$(
      git rev-list --count "$merge_commit"..HEAD 2>/dev/null || echo ""
    )"
  else
    new_commits=""
  fi

  if [ -n "$new_commits" ]; then
    if [ "$new_commits" -gt 0 ]; then
      status="ALL_MERGED_WITH_NEW_COMMITS"
      action="CREATE_PR"
      reason="$new_commits commits found after last merge"
    else
      status="ALL_MERGED_NO_NEW_COMMITS"
      action="NO_ACTION"
      reason="No commits found after last merge"
    fi
  else
    upstream_commits="$(
      git rev-list --count "origin/$head"..HEAD 2>/dev/null || echo ""
    )"
    fallback_commits="$(
      git rev-list --count "origin/$base"..HEAD 2>/dev/null || echo ""
    )"

    if [ -n "$upstream_commits" ] && [ "$upstream_commits" -gt 0 ]; then
      status="ALL_MERGED_WITH_NEW_COMMITS"
      action="CREATE_PR"
      reason="Fallback check found commits ahead of origin/$head"
    elif [ -n "$fallback_commits" ]; then
      if [ "$fallback_commits" -gt 0 ]; then
        status="ALL_MERGED_WITH_NEW_COMMITS"
        action="CREATE_PR"
        reason="Fallback check found commits ahead of origin/$base"
      else
        status="ALL_MERGED_NO_NEW_COMMITS"
        action="NO_ACTION"
        reason="Fallback check found no commits ahead of origin/$head or origin/$base"
      fi
    else
      status="CHECK_FAILED"
      action="MANUAL_CHECK"
      reason="Could not resolve merge commit and fallback comparison failed"
    fi
  fi
fi

latest_merged_pr="$(
  echo "$pr_json" \
    | jq -r 'map(select(.merged_at != null)) | sort_by(.updated_at) | last | .number // empty'
)"
unmerged_pr="$(
  echo "$pr_json" \
    | jq -r 'map(select(.merged_at == null)) | first | .number // empty'
)"
unmerged_pr_url="$(
  echo "$pr_json" \
    | jq -r 'map(select(.merged_at == null)) | first | .html_url // empty'
)"

case "$status" in
  NO_PR)
    echo ">> CREATE PR — No PR exists for \`$head\` -> \`$base\`."
    ;;
  UNMERGED_PR_EXISTS)
    echo "> PUSH ONLY — Unmerged PR open for \`$head\`."
    echo "   PR: #$unmerged_pr $unmerged_pr_url"
    ;;
  ALL_MERGED_WITH_NEW_COMMITS)
    n="${new_commits:-$upstream_commits}"
    echo ">> CREATE PR — $n new commit(s) after last merge (#$latest_merged_pr)."
    echo "   head: $head -> base: $base"
    ;;
  ALL_MERGED_NO_NEW_COMMITS)
    echo "-- NO ACTION — All PRs merged, no new commits on \`$head\`."
    ;;
  *)
    echo "!! MANUAL CHECK — Could not determine PR status."
    echo "   Reason: $reason"
    echo "   head: $head -> base: $base"
    ;;
esac

if [ "$dirty" -eq 1 ]; then
  echo "   (!) Worktree has uncommitted changes."
fi

Related skill

gwt-pr: creates/updates PRs
gwt-pr-fix: diagnoses and fixes failing PRs

Adoption

akiojin/gwt-pr-check

$ install --global

Security Scan Results

SKILL.md

GH PR Check

Overview

Decision rules (must follow)

Output contract

Language rule

Default output template

Status-to-action mapping (must use)

Example outputs

Workflow (recommended)

Quick start

Command snippet (bash)

Related skill

Related Skills

akiojin/tui-design

akiojin/gwt-spec-search

akiojin/gwt-search

akiojin/gwt-register-issue

akiojin/gwt-pr-check

$ install --global

Security Scan Results

SKILL.md

GH PR Check

Overview

Decision rules (must follow)

Output contract

Language rule

Default output template

Status-to-action mapping (must use)

Example outputs

Workflow (recommended)

Quick start

Command snippet (bash)

Related skill

Related Skills

akiojin/tui-design

akiojin/gwt-spec-search

akiojin/gwt-search

akiojin/gwt-register-issue