Agent skill

Ask Search

Web search via self-hosted SearxNG. An agent skill from ythx-101/ask-search.

MITAuto-check passedProductivity & Automation

Install Ask Search

skills CLI

$ npx skills add ythx-101/ask-search --skill ask-search -a claude-code

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

GitHub CLI

$ gh skill install ythx-101/ask-search ask-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).

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

Paste into Claude Code

Install the "ask-search" agent skill from https://github.com/ythx-101/ask-search/tree/master into .claude/skills/ask-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ask-search", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add ythx-101/ask-search --skill ask-search -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install ythx-101/ask-search ask-search --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "ask-search" agent skill from https://github.com/ythx-101/ask-search/tree/master into .agents/skills/ask-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ask-search", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add ythx-101/ask-search --skill ask-search -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install ythx-101/ask-search ask-search --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "ask-search" agent skill from https://github.com/ythx-101/ask-search/tree/master into .cursor/skills/ask-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ask-search", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add ythx-101/ask-search --skill ask-search -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install ythx-101/ask-search ask-search --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "ask-search" agent skill from https://github.com/ythx-101/ask-search/tree/master into .gemini/skills/ask-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ask-search", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install ythx-101/ask-search ask-search

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add ythx-101/ask-search --skill ask-search -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "ask-search" agent skill from https://github.com/ythx-101/ask-search/tree/master into .github/skills/ask-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ask-search", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add ythx-101/ask-search --skill ask-search -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install ythx-101/ask-search ask-search --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "ask-search" agent skill from https://github.com/ythx-101/ask-search/tree/master into .opencode/skills/ask-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ask-search", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: ask-search
GitHub stars: 537
Token cost: ~332 tokens
SKILL.md length: 89 words
Files: 10 (incl. scripts)
Skills in repo: 1
Repo updated: Mar 22, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Web search via self-hosted SearxNG. An agent skill from ythx-101/ask-search.

Works in 3 steps: Run ask-search "topic" to get candidates → Check snippet — if enough, answer directly → If snippet truncated, use web_fetch on…
Tasks that involve Web search
SKILL.md covers Usage, Agent Workflow, Parameters and Setup
Runs Python and Shell scripts from its folder

What it does

Ask Search is an agent skill from ythx-101/ask-search. Web search via self-hosted SearxNG. Aggregates Google, Bing, DuckDuckGo, Brave. Returns title/url/snippet. Zero API key required.

Its SKILL.md is about 330 tokens, which your agent loads only when the skill is triggered. The skill folder holds 12 other files, including scripts (for example `README.md`, `install.sh` and `mcp/server.py`).

It sits in Productivity & Automation, covering Web search. The repository describes itself as: Self-hosted web search skill for AI agents (OpenClaw/Claude Code/Antigravity) via SearxNG. The licence is MIT.

When your agent uses it

Tasks that involve Web search

Example prompts

“/ask-search”

Requirements

Python 3
A Bash shell

Workflow steps

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

Run ask-search "topic" to get candidates
Check snippet — if enough, answer directly
If snippet truncated, use web_fetch on the URL for full content

What it can do on your machine

Read from SKILL.md and the folder at commit 6cf7eaa. 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 and Shell), which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
- github.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

Ask Search loads about 332 tokens when it runs. Until then it costs about 35 tokens; SKILL.md has 89 words of instructions outside code blocks.

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

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 ythx-101/ask-search at commit 6cf7eaa, republished under its MIT licence (© ythx-101). 89 words, ~332 tokens.

Download SKILL.mdSave it as .claude/skills/ask-search/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.

name: ask-search
description: Web search via self-hosted SearxNG. Aggregates Google, Bing, DuckDuckGo, Brave. Returns title/url/snippet. Zero API key required.

ask-search

Web search powered by SearxNG. Aggregates multiple search engines, zero API key, full privacy.

Usage

bash

ask-search "your query"                    # top 10 results
ask-search "query" --num 5                 # limit results
ask-search "AI news" --categories news     # news only
ask-search "query" --lang zh-CN            # Chinese results
ask-search "query" --urls-only             # URL list (pipe to web_fetch)
ask-search "query" --json                  # raw JSON

Agent Workflow

Run ask-search "topic" to get candidates
Check snippet — if enough, answer directly
If snippet truncated, use web_fetch on the URL for full content

Parameters

Flag	Short	Description
`--num N`	`-n`	Max results (default 10)
`--engines`	`-e`	google,bing,duckduckgo,brave
`--lang`	`-l`	zh-CN, en, ja, ko
`--categories`	`-c`	general,news,images,science
`--json`	`-j`	Raw JSON output
`--urls-only`	`-u`	URLs only

Setup

Requires SearxNG running locally. Set SEARXNG_URL if not on default port 8080.

Files

SKILL.md and 9 other files (scripts) in the repository root of ythx-101/ask-search.

SKILL.md
.gitignore
LICENSE
README.md
install.sh
mcp/server.py
scripts/core.py
searxng/.env.example
searxng/docker-compose.yml
searxng/searxng.yml

Open the folder on GitHubat commit 6cf7eaa

Compare with similar skills

Ask 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.

Ask Search compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Ask Search this skillythx-101/ask-search	537	—	~332	Automated safety check: Pass	MIT	6 mo ago
Brave Searchbadlogic/pi-skills	2.6k	6 repos	~592	Automated safety check: Pass	MIT	4 mo ago
Enterprise AI Scenario MapMetaInFLow/Enterprise-ai-scenario-map-skill	632	—	~1.8k	Automated safety check: Pass	MIT	6 mo ago
Web Searchjjyaoao/HelloAgents	3.2k	1 repos	~5.6k	Automated safety check: Pass	MIT	2 days ago
Ddg SearchTheSyart/claude-agent-examples	405	1 repos	~493	Automated safety check: Pass	None	2 mo ago
Local Web SearchuluckyXH/OpenMOSS	1.3k	—	~392	Automated safety check: Notes	MIT	3 mo ago

Similar skills

Brave Search
badlogic/pi-skills
Web search and content extraction via Brave Search API. An agent skill from badlogic/pi-skills.
2.6k GitHub starsUsed in 6 repos~592 tokens
Productivity & AutomationAuto-check passed
Enterprise AI Scenario Map
MetaInFLow/Enterprise-ai-scenario-map-skill
企业AI场景地图生成报告工具。通过 web-search 深度调研企业信息，按照V2.1标准模板生成结构化AI应用场景地图报告，包含企业画像、业务诊断、行业实践、AI场景全量表、实施路径等完整内容。
632 GitHub stars~1.8k tokensUpdated 6 mo ago
Productivity & AutomationAuto-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
Ddg Search
TheSyart/claude-agent-examples
Web search without an API key using DuckDuckGo Lite via webfetch.
405 GitHub starsUsed in 1 repo~493 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
Web Search
EXboys/skilllite
Web search and content extraction with Tavily and Exa via inference.sh CLI.
170 GitHub starsUsed in 3 repos~1k tokens
Productivity & AutomationAuto-check passed

Questions about Ask Search

What does Ask Search do?

Web search via self-hosted SearxNG. An agent skill from ythx-101/ask-search. Ask Search is an agent skill from ythx-101/ask-search. Web search via self-hosted SearxNG.

When should I use Ask Search?

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

How do I install Ask Search in Claude Code?

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

How do I install Ask Search in Codex?

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

Can I use Ask 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 ythx-101/ask-search --skill ask-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/ask-search, .gemini/skills/ask-search, .github/skills/ask-search and .opencode/skills/ask-search in your project.

What does Ask Search need to run?

Going by SKILL.md and its folder, Ask Search needs Python and a shell for the scripts in its folder. Our summary lists: Python 3; A Bash shell.

Does Ask Search access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Ask 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 Ask Search use?

Ask Search is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ask Search use?

About 332 tokens (SKILL.md is roughly 1.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 Ask Search?

Skills that share tags, products or a category with Ask Search: Brave Search (badlogic/pi-skills, 2.6k stars), Enterprise AI Scenario Map (MetaInFLow/Enterprise-ai-scenario-map-skill, 632 stars), Web Search (jjyaoao/HelloAgents, 3.2k stars) and Ddg Search (TheSyart/claude-agent-examples, 405 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ask Search?

ythx-101 (a GitHub user) maintains it in ythx-101/ask-search, which has 537 GitHub stars. The repository was last updated on March 22, 2026.

Source: ythx-101/ask-search on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Ask Search

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

ask-search

Usage

Agent Workflow

Parameters

Setup

Files

Compare with similar skills

Similar skills

Brave Search

Enterprise AI Scenario Map

Web Search

Ddg Search

Local Web Search

Web Search

Related

Questions about Ask Search