Agent-Skills.md

Agent Skills: qry Search Skill

Web search using qry, a terminal-native agent-first search CLI that routes queries through pluggable adapters and always outputs JSON. Use this skill whenever you need to search the web for documentation, APIs, error messages, package info, changelogs, or any current information. Triggers on "search the web", "look up", "find docs for", "what's the latest version of", "check if X exists", or whenever current information is needed. Prefer this over ddgr or other search tools when qry is available.

UncategorizedID: justEstif/dotfiles/qry-search

Repository

justEstif/dotfiles
justEstif

Install this agent skill to your local

pnpm dlx add-skill https://github.com/justEstif/dotfiles/tree/HEAD/pi/.pi/agent/skills/qry-search

Skill Files

Browse the full folder contents for qry-search.

Download Skill

Loading file tree…

pi/.pi/agent/skills/qry-search/SKILL.md

Skill Metadata

Name
qry-search
Description
Web search using qry, a terminal-native agent-first search CLI that routes queries through pluggable adapters and always outputs JSON. Use this skill whenever you need to search the web for documentation, APIs, error messages, package info, changelogs, or any current information. Triggers on "search the web", "look up", "find docs for", "what's the latest version of", "check if X exists", or whenever current information is needed. Prefer this over ddgr or other search tools when qry is available.

qry Search Skill

qry routes search queries through pluggable adapter binaries and always outputs JSON.

Check availability

qry --agent-info   # prints tool description + your current config as JSON

If qry is not found, install it and at least one adapter:

# Install qry
mise use -g go:github.com/justestif/qry@latest && mise reshim

# Install an adapter (no API key required)
mise use -g go:github.com/justestif/qry/adapters/ddg-scrape@latest && mise reshim

See the qry README for all available adapters and config.

Core usage

# Basic search
qry "your query here"

# Limit results (default from config, usually 5–10)
qry --num 5 "your query"

# Force a specific adapter (bypass routing)
qry --adapter ddg-scrape "your query"

# Merge results from all pool adapters
qry --mode merge "your query"

Output format

first mode (default) — array of results:

[
  { "title": "...", "url": "https://...", "snippet": "..." }
]

merge mode — object with results (and optional warnings):

{
  "results": [{ "title": "...", "url": "https://...", "snippet": "..." }],
  "warnings": ["brave-api failed: rate_limited — results may be incomplete"]
}

Tips

  • Be specific — "python requests post json body example" beats "python http"
  • Version lookups — "numpy latest release site:pypi.org"
  • Error messages — wrap in quotes: qry '"ModuleNotFoundError: No module named X"'
  • Docs — "site:docs.python.org pathlib" gives cleaner results
  • After searching — fetch the most relevant URL for full content: curl -s <url> | cat
  • Partial failures in merge mode are non-fatal — results from successful adapters are returned alongside warnings