ModSearch - Search Bridge Skill

• User asks for web search, latest updates, or source-backed answers
• Current model/toolchain cannot perform direct search reliably
• You need structured search results before downstream summarization/fetch

Prerequisites

modsearch --version

gemini-cli

gemini --version

npm install -g @google/gemini-cli
gemini

npx

npx @google/gemini-cli          # launch interactive auth

Command

modsearch -q "<query>"
# or via npx
npx @liustack/modsearch -q "<query>"

modsearch -q "<query>" -o <output-json-path> -p <provider> -m <model> --max-results <n> --prompt "<extra constraints>"

Workflow

1. Run

   modsearch

   with the user query.
2. Parse JSON output.
3. Use

   summary

   and

   items

   as evidence for reasoning or for selecting URLs to fetch.
4. If

   uncertainty

   is non-empty, explicitly communicate ambiguity to the user.

Output Contract

• summary

  : high-level synthesis of search findings

• items

  : normalized list (

  title

  ,

  url

  ,

  snippet

  ,

  source

  ,

  published_at

  ,

  relevance

  )

• uncertainty

  : caveats, missing data, or confidence risks

references/output-schema.md

Failure Handling

• If provider command fails (missing auth, quota, network, binary not found), report exact error and suggest provider setup checks.
• If JSON is partially malformed, keep

  rawText

  and continue with best-effort extraction.

Implementation Note

gemini -p