القائمة
Search the web with automatic backend selection. Works out-of-the-box with public SearXNG. Optional Duck API for advanced filters. Supports images, news, videos.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Draw diagrams as code from text using the D2 language (d2lang.com). Use when the user wants to create, edit, validate, or render architecture diagrams, flowcharts, sequence diagrams, ER diagrams, class diagrams, or any .d2 file. Triggers: draw a diagram, architecture diagram, visualize the system, render d2, .d2 file.
Download videos, audio, subtitles, and clean paragraph-style transcripts from YouTube and any other yt-dlp supported site. Transcripts are saved to file by default. Use when asked to download this video, save this clip, rip audio, get subtitles, get transcript, or to troubleshoot yt-dlp/ffmpeg and formats/playlists.
Search YouTube for fresh, long, deep content — podcasts, lectures, and deep dives. Use when the user wants to find videos, look up a topic, get video recommendations, or asks about YouTube content. Defaults to longform (20min+), recent (18mo), high-relevance results with a combined recency+views+duration+relevance score.
Fetch and extract readable text content from web pages. Auto-selects best tool with smart fallback. Use when the user wants to read articles, documentation, or scrape text content from web pages. Works on Reddit, StackOverflow, GitHub, docs sites, and more.
Drive headless Chrome from the CLI for web scraping, screenshots, form filling, PDF export, accessibility audits, and browser smoke tests. Use when the user wants to automate browser interactions, scrape dynamic pages (JS-rendered content), take page screenshots or element screenshots, fill and submit web forms, export pages as PDF, run accessibility checks, or assert page state in CI/CD pipelines. Triggers on mentions of: browser automation, headless Chrome, web scraping, page screenshots, form automation, accessibility testing, browser testing, rodney.
Create and update concise AGENTS.md files using proven best practices. Use when starting a new AGENTS.md, refactoring an overly long or confusing one, adding missing build/test commands, or capturing gotchas and verification steps. Triggers on: AGENTS.md, agent instructions, project guide, CLAUDE.md, cursor rules, copilot instructions, agent onboarding.
| name | web-search |
| description | Search the web with automatic backend selection. Works out-of-the-box with public SearXNG. Optional Duck API for advanced filters. Supports images, news, videos. |
| metadata | {"author":"skale","version":"2.1.0"} |
web-search "your query" # That's it.
Works globally after install. No credentials needed (public SearXNG).
Linux / macOS (bash):
cd ~/.pi/agent/skills/web-search && ./install.sh
Windows (cmd):
cd %USERPROFILE%\.pi\agent\skills\web-search && install.bat
Creates a web-search command in ~/.local/bin/ (%USERPROFILE%\.local\bin\ on Windows). Requires uv (auto-installed).
web-search --update # Manual update (git pull + uv sync)
web-search --selfcheck # Show version + last update date
Auto-updates in the background every 7 days. No search is blocked — the update runs in a detached process.
Public SearXNG works out of the box. For better reliability:
Private SearXNG (recommended):
credgoo searx
# Returns: URL@username@password
Or set SEARXNG_URL env var, or create ~/.config/api_keys/searx.json.
Duck API (advanced filters):
credgoo WEB_SEARCH_BEARER
web-search "react hooks tutorial"
web-search "cats" --categories images
web-search "AI news" --categories news
web-search "query" --max 20
web-search "query" --time-range day
web-search "query" -v # verbose (shows backend on stderr)
web-search "query" --json # raw JSON to stdout
| Option | Description |
|---|---|
--max N | Max results (default: 10) |
--page N | Results page (default: 1) |
--categories CAT | images, news, videos |
--time-range RANGE | day, week, month, year — works on both backends |
--language LANG | Search language (default: en). SearXNG only. |
--region CODE | Region (e.g., us-en, de-de). Default: wt-wt. |
--json | Output raw JSON |
-v, --verbose | Show backend (printed to stderr) |
--api | Force Duck API backend |
--searxng | Force SearXNG backend |
--engines LIST | Comma-separated engines (SearXNG only) |
--update | Update the skill now |
--selfcheck | Show version and last update |
| Option | Description |
|---|---|
--site DOMAIN | Filter by domain |
--filetype EXT | Filter by file type (pdf, txt, etc.) |
--inurl TEXT | URL must contain text |
--exclude TERMS | Comma-separated terms to exclude |
--exact | Exact phrase match |
--timelimit D/W/M/Y | Time filter shorthand (Duck API only). Prefer --time-range. |
Duck API filters (
--site,--filetype,--inurl,--exclude,--exact) are silently ignored on SearXNG with a warning.
--time-range values must be lowercase: day, week, month, year-v, --verbose output goes to stderr — safe to pipe stdout0 = success, 1 = search error| Problem | Fix |
|---|---|
web-search: command not found | Add ~/.local/bin to PATH: export PATH="$HOME/.local/bin:$PATH" |
uv: command not found | Run install.sh again — it auto-installs uv |
| Dependency errors | web-search --update |
| All SearXNG instances fail | Configure a private instance via credgoo searx |
See references/INDEX.md for detailed examples, region codes, backend comparison, and authentication options.