web-search

Web search using DuckDuckGo (free, unlimited). Falls back to pi-web-access extension for content extraction.

215 stars

Best use case

web-search is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Web search using DuckDuckGo (free, unlimited). Falls back to pi-web-access extension for content extraction.

Teams using web-search should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/web-search/SKILL.md --create-dirs "https://raw.githubusercontent.com/megalithic/dotfiles/main/home/common/programs/ai/pi-coding-agent/skills/web-search/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/web-search/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How web-search Compares

Feature / Agentweb-searchStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Web search using DuckDuckGo (free, unlimited). Falls back to pi-web-access extension for content extraction.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Web Search

Primary: DuckDuckGo via `ddgr` (free, unlimited, no API key)
Content extraction: Use `pi-web-access` extension tools (gemini-search, etc.)

## Search (ddgr)

```bash
{baseDir}/search.sh "query"                    # Basic search (5 results)
{baseDir}/search.sh "query" -n 10              # More results (max 25)
{baseDir}/search.sh "query" -t w               # Past week
{baseDir}/search.sh "query" -t m               # Past month
{baseDir}/search.sh "query" -w example.com     # Site-specific search
```

### Options

- `-n <num>` - Number of results (default: 5, max: 25)
- `-t <span>` - Time filter: `d` (day), `w` (week), `m` (month), `y` (year)
- `-w <site>` - Limit to specific site

## Content extraction

For full page content (not just snippets), use the `pi-web-access` extension
which provides web search and extraction tools directly in the agent.

## Output format

```
--- Result 1 ---
Title: Page Title
URL: https://example.com/page
Snippet: Description from search results

--- Result 2 ---
...
```

## Rate limits

- **ddgr**: None (scrapes DuckDuckGo directly)

Related Skills

brave-search

215
from megalithic/dotfiles

Web search and content extraction via Brave Search API. Use for searching documentation, facts, or any web content. Lightweight, no browser required.

writing-clearly-and-concisely

215
from megalithic/dotfiles

Apply Strunk's timeless writing rules to ANY prose humans will read - documentation, commit messages, error messages, explanations, reports, or UI text. Makes your writing clearer, stronger, and more professional.

web-browser

215
from megalithic/dotfiles

Interact with web pages using agent-browser CLI. MUST run 'browser connect 9222' FIRST to use existing browser with authenticated sessions.

tmux

215
from megalithic/dotfiles

Remote control tmux sessions for interactive CLIs (python, gdb, etc.) by sending keystrokes and scraping pane output.

ticket-worker

215
from megalithic/dotfiles

Work on a single tk ticket end-to-end. Use when the user says 'work on ticket X' or when spawned by work-tickets.sh.

ticket-creator

215
from megalithic/dotfiles

Create and refine tickets for the tk ticket system. Use when the user says 'create tickets for X', 'refine ticket X', 'break this into tickets', 'seed tickets from plan', or anything about creating or refining tk tickets.

tell

215
from megalithic/dotfiles

Delegate tasks to other agents - pi sessions or external agents (claude, opencode, aider). Non-blocking with task tracking and completion notifications.

task-pipeline

215
from megalithic/dotfiles

Structured workflow for research → plan → tickets → work. Use when starting or continuing a task with /task, /plan, or /tickets commands.

preview

215
from megalithic/dotfiles

Display code, diffs, images, and other content in a tmux pane or popup. Auto-detects nvim/megaterm for floating popups.

mcpctl

215
from megalithic/dotfiles

Manage MCP server configurations — add, remove, list, inspect, troubleshoot. Use when asked to "add mcp server", "remove mcp", "list mcp servers", "mcp status", "configure mcp", "troubleshoot mcp", or any MCP server management task.

handoff

215
from megalithic/dotfiles

Save session state for later pickup. Use /handoff when context is degrading, /pickup to resume in a new session.

github

215
from megalithic/dotfiles

Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.