docs(skill): fix gh search query syntax guidance

BagToad · Copilot · BagToad · commit 4a31d5965e50 · 2026-06-12T10:20:22.000-06:00
gh search parses a bundled quoted query as a single phrase and fails
with "Invalid search query". Document passing each qualifier as its own
token or flag, and note the quoted-string form is only for the --search
flag on pr/issue list.

Co-authored-by: Copilot &lt;223556219+Copilot@users.noreply.github.com&gt;
diff --git a/skills/gh/SKILL.md b/skills/gh/SKILL.md
@@ -48,12 +48,16 @@ Pass `--repo OWNER/REPO` (`-R`) to override the resolved CWD repo.
 
 - `gh search issues|prs|code|repos|commits|users` uses GitHub's search
   index and accepts the full search syntax (`is:open`, `author:`,
-  `label:`, `repo:owner/name`, `in:title`, ...). Pass the entire query as
-  one quoted string, the same way you would for `--search`:
-  `gh search issues "is:open author:foo repo:cli/cli"`. Prefer it for
+  `label:`, `repo:owner/name`, `in:title`, ...). Pass each qualifier as
+  its own bare token, not as one quoted string:
+  `gh search issues repo:cli/cli is:open author:monalisa` works, but
+  `gh search issues "repo:cli/cli is:open"` is read as a single phrase and
+  fails with `Invalid search query`. Quote only multi-word free text
+  (`gh search issues "broken feature"`). Most qualifiers also have a
+  dedicated flag (`--repo`, `--author`, `--label`, ...). Prefer search for
   anything cross-repo or filtered by author/label.
-- `gh issue list --search "..."` and `gh pr list --search "..."` accept
-  the same syntax but are scoped to one repo.
+- `gh issue list --search "..."` and `gh pr list --search "..."` take the
+  query as one quoted string (it is a flag value) and are scoped to one repo.
 
 ## Issue types, sub-issues, and relationships
 
