Agent skill

Web Search

by meain in meain/dotfiles

Search the web using lynx and DuckDuckGo. An agent skill from meain/dotfiles.

MITAuto-check passedProductivity & Automation

Install Web Search

skills CLI
$ npx skills add meain/dotfiles --skill web-search -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install meain/dotfiles web-search --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/meain/dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agents/.agents/skills/web-search .claude/skills/web-search && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
web-search
GitHub stars
285
Token cost
~830 tokens
SKILL.md length
220 words
Files
2 (incl. scripts)
Skills in repo
35
Repo updated
First seen
Licence
MIT

At a glance

Search the web using lynx and DuckDuckGo. An agent skill from meain/dotfiles.

  • Works in 4 steps: Uses lynx to search DuckDuckGo with your… → Extracts clean search results with… → Can follow specific URLs to dump full… → …
  • Tasks that involve Web search
  • SKILL.md covers Usage, Examples, Features and How It Works, plus 2 more sections
  • Runs Python scripts from its folder; calls python3; reaches smartprix.com

What it does

Web Search is an agent skill from meain/dotfiles. Search the web using lynx and DuckDuckGo. Performs text-based web searches and can dump specific website content. Do NOT use in Claude Code — use the built-in WebSearch tool instead. Only use this skill in environments where WebSearch is unavailable.

Its SKILL.md is about 830 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/search.py`).

It sits in Productivity & Automation, covering Web search. It works with JavaScript. The repository describes itself as: If there is a shell, there is a way! The licence is MIT.

When your agent uses it

  • Tasks that involve Web search

Example prompts

  • “/web-search”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Uses lynx to search DuckDuckGo with your query
  2. Extracts clean search results with titles, descriptions, and URLs
  3. Can follow specific URLs to dump full content
  4. Provides structured, readable output

What it can do on your machine

Read from SKILL.md and the folder at commit 3e336e2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • smartprix.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Web Search loads about 830 tokens when it runs. Until then it costs about 65 tokens; SKILL.md has 220 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~65
When it runs · the whole SKILL.md, loaded when a task matches
~830

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from meain/dotfiles at commit 3e336e2, republished under its MIT licence (© meain). 220 words, ~830 tokens.

Download SKILL.mdSave it as .claude/skills/web-search/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
web-search
description
Search the web using lynx and DuckDuckGo. Performs text-based web searches and can dump specific website content. Do NOT use in Claude Code — use the built-in WebSearch tool instead. Only use this skill in environments where WebSearch is unavailable.
triggers
/web-search, search the web, search for, look up online, web search, find on the internet, search duckduckgo, search online, google this, find information about
metadata.author
meain
metadata.version
1.0.0
metadata.license
MIT

/web-search — Web Search Using Lynx + DuckDuckGo

Search the web using lynx text browser with DuckDuckGo. Bypasses bot protection and provides clean, text-based results.

Note: This skill should only be used when the built-in WebSearch tool is not available and no other more specific search tools exist (e.g., documentation APIs, specialized search tools). If WebSearch is available in the current environment, use that instead.

Usage

bash
# Basic web search
python3 ~/.agents/skills/web-search/scripts/search.py "search query"

# Search with more results
python3 ~/.agents/skills/web-search/scripts/search.py "search query" --limit 10

# Dump specific website content
python3 ~/.agents/skills/web-search/scripts/search.py --dump "https://example.com"

# Search and filter results
python3 ~/.agents/skills/web-search/scripts/search.py "search query" --filter "keyword"

Examples

bash
# Basic search
python3 ~/.agents/skills/web-search/scripts/search.py "best budget earbuds india under 5000"

# Technology news search
python3 ~/.agents/skills/web-search/scripts/search.py "golang 1.24 release notes"

# Get specific website content
python3 ~/.agents/skills/web-search/scripts/search.py --dump "https://www.smartprix.com/mobile_headphones/best-earbuds-under-5000-list"

# Search with filtering
python3 ~/.agents/skills/web-search/scripts/search.py "rust programming tutorial" --filter "beginner"

# Limit results
python3 ~/.agents/skills/web-search/scripts/search.py "machine learning courses" --limit 5

Features

  • Text-based browsing: Uses lynx to bypass JavaScript and bot protection
  • Clean output: Extracts readable content without ads and distractions
  • DuckDuckGo integration: Privacy-focused search engine
  • Website dumping: Can extract content from specific URLs
  • Result filtering: Filter results by keywords
  • Configurable limits: Control number of search results

How It Works

  1. Uses lynx to search DuckDuckGo with your query
  2. Extracts clean search results with titles, descriptions, and URLs
  3. Can follow specific URLs to dump full content
  4. Provides structured, readable output

Requirements

  • lynx text browser (already available in your environment)
  • Python 3 (for the search script)

Notes

  • Lynx bypasses most bot protection mechanisms
  • Results are text-only (no images or JavaScript content)
  • DuckDuckGo provides privacy-focused search without tracking
  • Works well for technical documentation, news, and informational sites
  • Some heavily JavaScript-dependent sites may not render properly
  • For fetching individual web pages: Use curl and html2markdown instead of the --dump option for better compatibility and cleaner output

© meain, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in agents/.agents/skills/web-search of meain/dotfiles.

  • SKILL.md
  • scripts/search.py

Open the folder on GitHubat commit 3e336e2

Compare with similar skills

Web Search next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Web Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Web Search this skillmeain/dotfiles285—~830Automated safety check: PassMIT
Bright Data MCPbrightdata/skills2641 repos~3.7kAutomated safety check: PassMIT
Scrapingbee CLIScrapingBee/scrapingbee-cli108—~3.2kAutomated safety check: NotesMIT
Brightdata SDK JSbrightdata/skills264—~3kAutomated safety check: PassMIT
Tavily Search API Integrationandrewyng/context-hub14k—~1.1kAutomated safety check: PassMIT
Web Searchjjyaoao/HelloAgents3.2k1 repos~5.6kAutomated safety check: PassMIT

Similar skills

  • Bright Data MCP

    brightdata/skills

    Bright Data MCP handles ALL web data operations. An agent skill from brightdata/skills.

    264 GitHub starsUsed in 1 repo~3.7k tokens
    Productivity & AutomationAuto-check passed
  • Scrapingbee CLI

    ScrapingBee/scrapingbee-cli

    Fetch and read any web page, search the web, crawl a site, or pull structured data out of pages.

    108 GitHub stars~3.2k tokensUpdated yesterday
    Productivity & AutomationAuto-check: notes
  • Brightdata SDK JS

    brightdata/skills

    Web data extraction and discovery using the Bright Data JavaScript/TypeScript SDK (@brightdata/sdk).

    264 GitHub stars~3k tokensUpdated 2 days ago
    Productivity & AutomationAuto-check passed
  • Tavily Search API Integration

    andrewyng/context-hub

    Guides building Tavily integrations for web search, URL extraction, site crawling and AI-assisted research in Python or JavaScript agent and RAG projects.

    14k GitHub stars~1.1k tokensUpdated 4 mo ago
    AI & LLM EngineeringAuto-check passed
  • Web Search

    jjyaoao/HelloAgents

    Implement web search capabilities using the z-ai-web-dev-sdk.

    3.2k GitHub starsUsed in 1 repo~5.6k tokens
    Productivity & AutomationAuto-check passed
  • Local Web Search

    uluckyXH/OpenMOSS

    A skill your agent uses when the user asks for web search that should run via the local-160 Responses API with websearch tool (base URL like https://proxy.example.com, model gpt-5.2-codex(xhigh)).

    1.3k GitHub stars~392 tokensUpdated 3 mo ago
    Productivity & AutomationAuto-check: notes

More from meain/dotfiles

All 35 skills in this repo
  • Recall

    meain/dotfiles

    Search past Claude Code and Codex sessions. An agent skill from meain/dotfiles.

    285 GitHub starsUsed in 1 repo~684 tokens
    Auto-check passed
  • Grill With Docs

    meain/dotfiles

    Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise.

    285 GitHub starsUsed in 20 repos~875 tokens
    Auto-check passed
  • Backlog

    meain/dotfiles

    Daily backlog management — full planning review OR add a single entry from a URL.

    285 GitHub stars~3k tokensUpdated yesterday
    Auto-check passed
  • Concern Review

    meain/dotfiles

    Generate an interactive local HTML review page for a large PR or diff, grouping the changed files by logical concern (not just by file) so a reviewer can go through one theme at a time instead of a…

    285 GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed
  • My Weekly Report

    meain/dotfiles

    Generate a concise weekly status update in team format. An agent skill from meain/dotfiles.

    285 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed
  • Explain Tests

    meain/dotfiles

    Explain test code changes as a side-by-side HTML page — real test code on the left, a short note on the right saying which case that code covers.

    285 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Web Search

What does Web Search do?

Search the web using lynx and DuckDuckGo. An agent skill from meain/dotfiles. Web Search is an agent skill from meain/dotfiles. Search the web using lynx and DuckDuckGo.

When should I use Web Search?

Web Search fits situations like: tasks that involve Web search.

How do I install Web Search in Claude Code?

Run `npx skills add meain/dotfiles --skill web-search -a claude-code`. Or copy the skill folder (agents/.agents/skills/web-search in meain/dotfiles) into .claude/skills/web-search in your project. Claude Code loads it when a task matches its description.

How do I install Web Search in Codex?

Run `npx skills add meain/dotfiles --skill web-search -a codex`. Or copy the skill folder (agents/.agents/skills/web-search in meain/dotfiles) into .agents/skills/web-search in your project. Codex loads it when a task matches its description.

Can I use Web Search in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add meain/dotfiles --skill web-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/web-search, .gemini/skills/web-search, .github/skills/web-search and .opencode/skills/web-search in your project.

What does Web Search need to run?

Going by SKILL.md and its folder, Web Search needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Web Search access the network?

SKILL.md names 1 domain. In commands or code: smartprix.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Web Search safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Web Search use?

Web Search is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Web Search use?

About 830 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Web Search?

Skills that share tags, products or a category with Web Search: Bright Data MCP (brightdata/skills, 264 stars), Scrapingbee CLI (ScrapingBee/scrapingbee-cli, 108 stars), Brightdata SDK JS (brightdata/skills, 264 stars) and Tavily Search API Integration (andrewyng/context-hub, 14k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Web Search?

meain (a GitHub user) maintains it in meain/dotfiles, which has 285 GitHub stars. The repository holds 35 skills in this directory. The repository was last updated on October 8, 2026.

Source: meain/dotfiles on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.