search - SKILL.md Agent Skill

name: search description: Use when the user wants to find prior work, checkpoints, or agent conversations by topic, repo, branch, author, or recent time window

Use entire search to find relevant checkpoints before guessing from memory.

Begin the first response to this skill invocation with the line:

Entire Search:

followed by a blank line, then the content.

Apply the header to the first response of the invocation only. Do not re-print it on follow-up turns within the same invocation (e.g. after the user answers a clarifying question).
Do not include the header on error or early-exit responses (e.g. "Entire CLI not installed", "authentication required", "no matches"). The header's presence should signal that the skill ran and produced real output.

The user asks things like "have we done this before?", "search past work", "find the previous implementation", or "look for checkpoints about X"
You need prior context from another branch, repo, author, or recent time period
You want likely matches first, then a deeper transcript read only for the best hit

Do not use this for the current active session. Use session-handoff for that.

entire search "<query>" --json

Add filters when the user already gave them or when the first search is too broad:

entire search "<query>" --json --repo owner/name --branch branch-name --author "Name" --date week

Inline filters are also supported in the query: author:<name>, date:<week|month>, branch:<name>, repo:<owner/name>, repo:*.

Review the top matches and summarize the likely candidates for the user. Do not dump raw JSON unless they ask for it.
If the user wants details on a specific result, open the checkpoint with:

entire explain --checkpoint <checkpoint-id> --full --no-pager

If --full fails, fall back to:

entire explain --checkpoint <checkpoint-id> --raw-transcript --no-pager

Start with the user's domain terms, feature name, error text, file name, or ticket ID
Prefer narrower searches before increasing --limit
Add --repo or repo:* explicitly when repository scope matters
If there are no useful hits, broaden in this order: remove branch filter, widen date, simplify query terms

If search says authentication is required, tell the user to run entire login
If there are no matches, say that clearly and mention the filters or query terms you tried
If the user really wants the current session, switch to session-handoff instead of searching checkpoints