From 01e345082cd816e2485cf88aea0f3b731dc5d09e Mon Sep 17 00:00:00 2001
From: Kynan Ware <47394200+BagToad@users.noreply.github.com>
Date: Mon, 20 Apr 2026 14:21:26 -0600
Subject: [PATCH] fix totalCount guidance

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
---
 skills/gh/SKILL.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/skills/gh/SKILL.md b/skills/gh/SKILL.md
index 366978d15..34cce8bc2 100644
--- a/skills/gh/SKILL.md
+++ b/skills/gh/SKILL.md
@@ -32,8 +32,9 @@ List commands cap results.
 
 - `gh issue list`, `gh pr list`, `gh search ...`: pass `-L N` (`--limit N`).
   The default is usually 30.
-- Use `--json totalCount` to get the total number of items. This helps you know
-  if you need to paginate.
+- `gh issue list` / `gh pr list` do not expose aggregate totals like
+  `totalCount` via `--json`. If you need a true total, use `gh api graphql`
+  to query `totalCount`; otherwise, treat `-L` as the cap for the current call.
 - For raw API calls use `gh api --paginate <path>`. Combine with
   `--jq` and (optionally) `--slurp` to assemble one array.