How do I install the Ddg skill?

Run npx skillmds@latest add dvcrn/ddg in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ddg?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ddg by dvcrn — Agent Skill

Name: Ddg
Rating: 4.2 (5 reviews)
Author: dvcrn

Ddg

Use ddgr (DuckDuckGo from the terminal) to perform privacy-focused web searches from the command line. Use when the user wants to (1) Search the web from the terminal, (2) Perform DuckDuckGo searches without opening a browser, (3) Get quick search results in text format, (4) Search privately without tracking, (5) Use DuckDuckGo bangs (!) from terminal.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

ddgr - DuckDuckGo from the Terminal

ddgr is a command-line utility to search DuckDuckGo from the terminal. It provides fast, privacy-focused web searches without opening a browser.

Installation

Via Snap (recommended for Ubuntu):

sudo snap install ddgr

Via PPA:

sudo add-apt-repository ppa:twodopeshaggy/jarun
sudo apt-get update
sudo apt-get install ddgr

From source:

git clone https://github.com/jarun/ddgr.git
cd ddgr
sudo make install

Dependencies: Python 3.8 or later

Basic Usage

Simple search (non-interactive):

snap run ddgr "search query" --np

Search with specific number of results:

snap run ddgr "search query" --num 5 --np

Search with time limit:

snap run ddgr "query" --time w --np    # past week
snap run ddgr "query" --time m --np    # past month
snap run ddgr "query" --time y --np    # past year

Site-specific search:

snap run ddgr "query" --site github.com --np

JSON output:

snap run ddgr "query" --json --np

Open first result in browser:

snap run ddgr "query" --ducky

Interactive Mode

Run without --np to enter interactive mode:

snap run ddgr "search query"

Interactive commands:

1, 2, 3... → open result in browser
n → next page of results
p → previous page of results
q or Ctrl+D → quit
? → show help

Advanced Options

Option	Description
`-n N`, `--num N`	Show N results per page (0-25, default 10)
`-r REG`, `--reg REG`	Region-specific search (e.g., 'us-en', 'uk-en')
`-t SPAN`, `--time SPAN`	Time limit: d (day), w (week), m (month), y (year)
`-w SITE`, `--site SITE`	Search specific site
`-x`, `--expand`	Show complete URLs
`--json`	Output in JSON format
`--ducky`	Open first result in browser
`--np`, `--noprompt`	Non-interactive mode
`--unsafe`	Disable safe search

DuckDuckGo Bangs

Use DuckDuckGo bangs to search specific sites:

snap run ddgr "!w Linux" --np        # Wikipedia search
snap run ddgr "!yt music" --np       # YouTube search
snap run ddgr "!gh python" --np      # GitHub search
snap run ddgr "!a books" --np        # Amazon search

Make it Easier with an Alias

Add to ~/.bashrc or ~/.zshrc:

alias ddg='snap run ddgr'

Then use:

ddg "search query" --np

Privacy Features

No user tracking or profiling
Do Not Track enabled by default
Works over Tor network (with proxy)
HTTPS proxy support
No stored search history

Examples

Search for tech news:

snap run ddgr "latest AI news 2025" --num 5 --np

Find Ubuntu tutorials:

snap run ddgr "Ubuntu tutorial" --site askubuntu.com --np

Search recent Python documentation:

snap run ddgr "Python 3.12 features" --time m --np

Use bang to search Wikipedia:

snap run ddgr "!w OpenClaw" --np

Troubleshooting

Command not found:

Ensure ddgr is installed via snap: sudo snap install ddgr
Use full command: snap run ddgr instead of just ddgr

No results:

Check internet connection
Try without --np to see if interactive mode works
Verify DuckDuckGo is accessible in your region

Slow response:

DuckDuckGo HTML interface can be slower than main site
Use --time to limit results by time for faster queries

More Information

---name: ddgdescription: Use ddgr (DuckDuckGo from the terminal) to perform privacy-focused web searches from the command line. Use when the user wants to (1) Search the web from the terminal, (2) Perform DuckDuckGo searches without opening a browser, (3) Get quick search results in text format, (4) Search privately without tracking, (5) Use DuckDuckGo bangs (!) from terminal.---# ddgr - DuckDuckGo from the Terminal**ddgr** is a command-line utility to search DuckDuckGo from the terminal. It provides fast, privacy-focused web searches without opening a browser.## Installation### Via Snap (recommended for Ubuntu):```bashsudo snap install ddgr```### Via PPA:```bashsudo add-apt-repository ppa:twodopeshaggy/jarunsudo apt-get updatesudo apt-get install ddgr```### From source:```bashgit clone https://github.com/jarun/ddgr.gitcd ddgrsudo make install```**Dependencies:** Python 3.8 or later## Basic Usage### Simple search (non-interactive):```bashsnap run ddgr "search query" --np```### Search with specific number of results:```bashsnap run ddgr "search query" --num 5 --np```### Search with time limit:```bashsnap run ddgr "query" --time w --np # past weeksnap run ddgr "query" --time m --np # past monthsnap run ddgr "query" --time y --np # past year```### Site-specific search:```bashsnap run ddgr "query" --site github.com --np```### JSON output:```bashsnap run ddgr "query" --json --np```### Open first result in browser:```bashsnap run ddgr "query" --ducky```## Interactive ModeRun without `--np` to enter interactive mode:```bashsnap run ddgr "search query"```**Interactive commands:**- `1`, `2`, `3`... → open result in browser- `n` → next page of results- `p` → previous page of results- `q` or `Ctrl+D` → quit- `?` → show help## Advanced Options| Option | Description ||--------|-------------|| `-n N`, `--num N` | Show N results per page (0-25, default 10) || `-r REG`, `--reg REG` | Region-specific search (e.g., 'us-en', 'uk-en') || `-t SPAN`, `--time SPAN` | Time limit: d (day), w (week), m (month), y (year) || `-w SITE`, `--site SITE` | Search specific site || `-x`, `--expand` | Show complete URLs || `--json` | Output in JSON format || `--ducky` | Open first result in browser || `--np`, `--noprompt` | Non-interactive mode || `--unsafe` | Disable safe search |## DuckDuckGo BangsUse DuckDuckGo bangs to search specific sites:```bashsnap run ddgr "!w Linux" --np # Wikipedia searchsnap run ddgr "!yt music" --np # YouTube searchsnap run ddgr "!gh python" --np # GitHub searchsnap run ddgr "!a books" --np # Amazon search```## Make it Easier with an AliasAdd to `~/.bashrc` or `~/.zshrc`:```bashalias ddg='snap run ddgr'```Then use:```bashddg "search query" --np```## Privacy Features- No user tracking or profiling- Do Not Track enabled by default- Works over Tor network (with proxy)- HTTPS proxy support- No stored search history## Examples### Search for tech news:```bashsnap run ddgr "latest AI news 2025" --num 5 --np```### Find Ubuntu tutorials:```bashsnap run ddgr "Ubuntu tutorial" --site askubuntu.com --np```### Search recent Python documentation:```bashsnap run ddgr "Python 3.12 features" --time m --np```### Use bang to search Wikipedia:```bashsnap run ddgr "!w OpenClaw" --np```## Troubleshooting**Command not found:**- Ensure ddgr is installed via snap: `sudo snap install ddgr`- Use full command: `snap run ddgr` instead of just `ddgr`**No results:**- Check internet connection- Try without `--np` to see if interactive mode works- Verify DuckDuckGo is accessible in your region**Slow response:**- DuckDuckGo HTML interface can be slower than main site- Use `--time` to limit results by time for faster queries## More Information- GitHub: https://github.com/jarun/ddgr- DuckDuckGo: https://duckduckgo.com- Bangs: https://duckduckgo.com/bang

Frequently asked questions

Ddg