58 lines
1.5 KiB
Markdown
58 lines
1.5 KiB
Markdown
---
|
||
name: duckduckgo-search
|
||
intent: search, web
|
||
description: Use the `ddgr` CLI to search DuckDuckGo and return a small set of relevant, linkable sources.
|
||
---
|
||
|
||
# DuckDuckGo Search (ddgr)
|
||
|
||
## Purpose
|
||
|
||
When this skill is active, you use the `ddgr` command-line tool to search DuckDuckGo from the terminal and return credible, relevant sources.
|
||
|
||
This is a *search* skill. If you need to read/summarize a specific page after finding it, switch to a page-fetching/reader skill.
|
||
|
||
## Non-interactive usage (important)
|
||
|
||
`ddgr` is interactive by default. For agent use, you should run it non-interactively:
|
||
|
||
- Use `--np` / `--noprompt` to “perform search and exit, do not prompt”.
|
||
- Prefer `--json` for structured output (it also implies `--np`).
|
||
|
||
## Common patterns
|
||
|
||
### Minimal JSON search (recommended)
|
||
|
||
```bash
|
||
ddgr --json "<query>"
|
||
```
|
||
|
||
### Limit result count
|
||
|
||
```bash
|
||
ddgr --np -n 5 "<query>"
|
||
ddgr --json -n 5 "<query>"
|
||
```
|
||
|
||
### Narrow by recency / region / site
|
||
|
||
```bash
|
||
ddgr --json -t w "<query>" # last week
|
||
ddgr --json -r us-en "<query>" # US region
|
||
ddgr --json -w example.com "<query>" # site:example.com
|
||
```
|
||
|
||
## Output requirements
|
||
|
||
- Return a short list of results (usually 3–7) with:
|
||
- title
|
||
- URL
|
||
- a 1-sentence reason it’s relevant
|
||
- Prefer primary sources (official docs, vendor pages, standards bodies) over reposts.
|
||
- If results look low-quality, refine the query (add vendor name, add a site filter, or add a time window).
|
||
|
||
## Execution configuration
|
||
|
||
- Preferred tool: `ddgr`
|
||
- Non-interactive flags: `--json` (preferred) or `--np`
|