search: sync skill with CLI v0.10.0 (--compact, GA code search, multi-repo, cross-repo explain)

[evisdren]

Summary

Accuracy-and-writing pass on the search skill against Entire CLI v0.10.0 (released 2026-08-12), using the recent CLI search PRs as the source of truth. The previous revision predated all of them:

• Teach --json --compact as the default query shape (CLI #1908, ENT-1527): compact hits carry id, type, repo, branch, author, date, truncated title, snippet, filesTouched, score — never the full prompt. The old --limit 5 full-prompt workaround becomes the documented fallback for pre-0.10.0 CLIs.
• Remove the admin/insider gating for code search (CLI #1975 removed the ENTIRE_CODE_SEARCH flag): the "Code Search Fallback" section is gone; a slimmer degradation note covers skipped regions and unindexed repos.
• Multi-repo --repo (CLI #1845): repeatable and comma-separated, both search modes.
• Cross-repo drill-down (CLI #1963/#1942): entire checkpoint explain <id> --repo <owner/name> for checkpoint hits from other GitHub repos, plus the --session bridge for session hits and which hit types can't be explained at all.
• Drop the stale "entire explain --checkpoint is a deprecated alias" claim — the top-level command no longer exists; explain is registered only under the checkpoint group.
• Failure modes updated for the v0.10.0 "cannot search this repo yet" message (CLI #1944) and a warning that bare entire search opens a TUI.

Kept intact: the Entire Search: response-format convention, the benchmark-derived "answer from compact fields, skip explain unless needed" guidance from #39, and the search heuristics.

Every taught flag was verified against the CLI source at v0.10.0's cut and cross-checked against the CLI's own managed subagent templates (setup_search_skill.go), which shipped the same guidance in entireio/cli#1963.

Note for reviewers: open PR #38 here migrates other skills to entire checkpoint search, but entireio/cli#1963 made top-level entire search the canonical stable spelling (with checkpoint search as a permanent alias) — #38 may want re-review in that light.

Skill changed

• No skill changed
• New skill
• Existing skill: search

Validation

• npx -y skills@latest add . --list --yes
• JSON metadata validated, if changed
• OpenCode plugin syntax checked, if changed
• Markdown previewed, if changed

Example prompt

search past work for how we implemented the checkpoint pre-push OPF rewrite

🤖 Generated with Claude Code

---

Note

^{Cursor Bugbot is generating a summary for commit 71b5b50. Configure here.}

[evisdren]

bugbot run

[cursor]

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit 52ac29b. Configure here.}