Brave Search
badlogic/pi-skills
Web search and content extraction via Brave Search API. An agent skill from badlogic/pi-skills.
Search the web using Brave Search API for fast, privacy-respecting results with localization, freshness filtering, and extra snippets.
$ npx skills add jwynia/agent-skills --skill web-search-brave -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install jwynia/agent-skills web-search-brave --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/jwynia/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/general/research/tools/web-search-brave .claude/skills/web-search-brave && rm -rf skills-srcUse ~/.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/
Install the "web-search-brave" agent skill from https://github.com/jwynia/agent-skills/tree/main/skills/general/research/tools/web-search-brave into .claude/skills/web-search-brave/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "web-search-brave", 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.
$skill-installer install https://github.com/jwynia/agent-skills/tree/main/skills/general/research/tools/web-search-braveType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add jwynia/agent-skills --skill web-search-brave -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install jwynia/agent-skills web-search-brave --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jwynia/agent-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/general/research/tools/web-search-brave .agents/skills/web-search-brave && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "web-search-brave" agent skill from https://github.com/jwynia/agent-skills/tree/main/skills/general/research/tools/web-search-brave into .agents/skills/web-search-brave/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "web-search-brave", 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.
$ npx skills add jwynia/agent-skills --skill web-search-brave -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install jwynia/agent-skills web-search-brave --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jwynia/agent-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/general/research/tools/web-search-brave .cursor/skills/web-search-brave && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "web-search-brave" agent skill from https://github.com/jwynia/agent-skills/tree/main/skills/general/research/tools/web-search-brave into .cursor/skills/web-search-brave/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "web-search-brave", 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.
$ gemini skills install https://github.com/jwynia/agent-skills.git --path skills/general/research/tools/web-search-brave--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add jwynia/agent-skills --skill web-search-brave -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install jwynia/agent-skills web-search-brave --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jwynia/agent-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/general/research/tools/web-search-brave .gemini/skills/web-search-brave && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "web-search-brave" agent skill from https://github.com/jwynia/agent-skills/tree/main/skills/general/research/tools/web-search-brave into .gemini/skills/web-search-brave/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "web-search-brave", 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.
$ gh skill install jwynia/agent-skills web-search-braveInstalls 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).
$ npx skills add jwynia/agent-skills --skill web-search-brave -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/jwynia/agent-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/general/research/tools/web-search-brave .github/skills/web-search-brave && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "web-search-brave" agent skill from https://github.com/jwynia/agent-skills/tree/main/skills/general/research/tools/web-search-brave into .github/skills/web-search-brave/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "web-search-brave", 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.
$ npx skills add jwynia/agent-skills --skill web-search-brave -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install jwynia/agent-skills web-search-brave --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jwynia/agent-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/general/research/tools/web-search-brave .opencode/skills/web-search-brave && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "web-search-brave" agent skill from https://github.com/jwynia/agent-skills/tree/main/skills/general/research/tools/web-search-brave into .opencode/skills/web-search-brave/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "web-search-brave", 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.
web-search-braveSearch the web using Brave Search API for fast, privacy-respecting results with localization, freshness filtering, and extra snippets.
Web Search Brave is an agent skill from jwynia/agent-skills. Search the web using Brave Search API for fast, privacy-respecting results with localization, freshness filtering, and extra snippets. Use when you need web search results with country/language targeting or time-based filtering. Requires BRAVEAPIKEY. Keywords: brave, web search, localized search, privacy search, freshness filtering.
Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/search.ts`). Compatibility notes: Requires BRAVEAPIKEY environment variable and internet access
It sits in Productivity & Automation, covering Web search. It works with Brave Search API. The licence is MIT.
3 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit e02ec7e. It shows what the files ask for, not the result of running them.
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.
Ships 1 file in scripts/ (TypeScript), which the agent can run.
Shell commands in SKILL.md call:
denoFrom the folder's file list and the shell code blocks in SKILL.md.
Hosts in commands or code, which the agent is likely to contact:
react.devAlso links to:
brave.comFrom URLs in SKILL.md, links to its own repository left out.
Names these keys or tokens, usually read from environment variables:
BRAVE_API_KEYFrom names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Requires BRAVE_API_KEY environment variable and internet access
From compatibility in the SKILL.md frontmatter.
Web Search Brave loads about 2k tokens when it runs. Until then it costs about 88 tokens; SKILL.md has 757 words of instructions outside code blocks.
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.
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.
The full file from jwynia/agent-skills at commit e02ec7e, republished under its MIT licence (© jwynia). 757 words, ~1,988 tokens.
.claude/skills/web-search-brave/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.Search the web using Brave's Search API. Returns web results with descriptions, optional extra snippets, and support for country/language targeting.
Note: This skill requires a Brave Search API key. For basic web search using the agent's built-in capability, see web-search. For AI-optimized results with relevance scores, see web-search-tavily.
Use this skill when:
Do NOT use this skill when:
web-search-tavily instead)Before using this skill, ensure:
Get a Brave Search API key at: https://brave.com/search/api/
Run a simple search:
deno run --allow-env --allow-net=api.search.brave.com scripts/search.ts "your search query"Example with freshness filter:
deno run --allow-env --allow-net=api.search.brave.com scripts/search.ts "React 19 new features" --freshness pwdeno run --allow-env --allow-net=api.search.brave.com scripts/search.ts [options] "query"| Option | Description | Default |
|---|---|---|
--results <n> | Number of results to return (max 20) | 5 |
--freshness <range> | Time filter: pd, pw, pm, or py | none |
--country <code> | Country code for localized results (e.g., US, GB, DE) | none |
--lang <code> | Search language (e.g., en, fr, de) | none |
--safesearch <level> | Safe search: off, moderate, or strict | moderate |
--extra-snippets | Include additional content snippets | false |
--offset <n> | Pagination offset | 0 |
--json | Output as JSON (for programmatic use) | false |
--help | Show help message | - |
Filter results by recency:
Use standard 2-character country codes to get localized results:
US (United States), GB (United Kingdom), DE (Germany), FR (France), JP (Japan), etc.Search: "React 19 new features"
Found 5 results in 189ms
1. React 19 Release Notes
https://react.dev/blog/2024/04/25/react-19
React 19 is now available on npm! This release includes...
Age: 2 months ago
2. What's New in React 19
https://example.com/react-19-features
A comprehensive overview of React 19's new features...{
"query": "React 19 new features",
"results": [
{
"title": "React 19 Release Notes",
"url": "https://react.dev/blog/2024/04/25/react-19",
"description": "React 19 is now available on npm...",
"age": "2 months ago",
"language": "en",
"family_friendly": true
}
],
"response_time": 189,
"total_results": 1250000
}| Field | Type | Description |
|---|---|---|
title | string | Page title |
url | string | Source URL |
description | string | Relevant excerpt from the page |
extra_snippets | string[] | Additional content snippets (only with --extra-snippets) |
age | string | How old the result is (e.g., "2 hours ago") |
language | string | Language of the result |
family_friendly | boolean | Whether the result is family-friendly |
Scenario: Find recent news about a technology topic
scripts/search.ts "OpenAI GPT-5 announcement" --freshness pw --results 10Expected output: Recent web results about GPT-5 from the past week
Scenario: Find specific technical documentation
scripts/search.ts "Deno deploy edge functions tutorial" --results 10 --extra-snippetsExpected output: Comprehensive results with extra snippets from documentation and tutorial sites
Scenario: Find results targeted to a specific country and language
scripts/search.ts "aktuelle Nachrichten" --country DE --lang de --freshness pdExpected output: German-language results from Germany from the past day
Scenario: Get structured results with strict safe search
scripts/search.ts "machine learning tutorials" --safesearch strict --extra-snippets --jsonExpected output: JSON results with extra snippets, filtered for safe content
Symptoms: Script exits immediately with API key error
Solution:
export BRAVE_API_KEY="your-api-key-here"BRAVE_API_KEY="your-key" deno run --allow-env --allow-net=api.search.brave.com scripts/search.ts "query"Symptoms: 401 authentication error
Solution:
Symptoms: 429 error response
Solution:
Symptoms: Empty results array
Solution:
This skill has the following limitations:
web-search-tavily for that)© jwynia, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 1 other file (scripts) in skills/general/research/tools/web-search-brave of jwynia/agent-skills.
Open the folder on GitHubat commit e02ec7e
Web Search Brave 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Web Search Brave this skilljwynia/agent-skills | 170 | — | ~2k | Automated safety check: Pass | MIT | |
| Brave Searchbadlogic/pi-skills | 2.6k | 5 repos | ~592 | Automated safety check: Pass | MIT | |
| Web Searchtmustier/pi-for-excel | 434 | — | ~410 | Automated safety check: Pass | MIT | |
| Brave SearchLeoYeAI/openclaw-master-skills | 2.2k | — | ~4.6k | Automated safety check: Pass | MIT | |
| Brave SearchAnil-matcha/awesome-muse-connectors | 1.3k | — | ~440 | Automated safety check: Pass | MIT | |
| Qryma Searchaiskillstore/marketplace | 433 | — | ~567 | Automated safety check: Notes | MIT |
badlogic/pi-skills
Web search and content extraction via Brave Search API. An agent skill from badlogic/pi-skills.
tmustier/pi-for-excel
Search the public web for up-to-date facts. An agent skill from tmustier/pi-for-excel.
LeoYeAI/openclaw-master-skills
Brave Search API integration with managed authentication. An agent skill from LeoYeAI/openclaw-master-skills.
Anil-matcha/awesome-muse-connectors
Independent web search from Brave's own index. An agent skill from Anil-matcha/awesome-muse-connectors.
aiskillstore/marketplace
Search the web with multiple output formats using the Qryma API.
decolua/9router
Runs web, news and public X searches through a 9Router gateway's search endpoint, choosing among providers such as Tavily, Exa, Brave and Perplexity.
jwynia/agent-skills
Diagnose devcontainer configuration problems and guide development environment setup.
jwynia/agent-skills
Create distinctive, production-grade frontend interfaces with high design quality.
jwynia/agent-skills
Orchestrate agile development workflows for Gitea repositories using the tea CLI.
jwynia/agent-skills
Generate game assets using AI image generation APIs (DALL-E, Replicate, fal.ai) and prepare them for Godot.
jwynia/agent-skills
Develop AI agents, tools, and workflows with Mastra v1 Beta and Hono servers.
jwynia/agent-skills
Create and manipulate PowerPoint PPTX files programmatically.
Works with
Categories
Search the web using Brave Search API for fast, privacy-respecting results with localization, freshness filtering, and extra snippets. Web Search Brave is an agent skill from jwynia/agent-skills. Search the web using Brave Search API for fast, privacy-respecting results with localization, freshness filtering, and extra snippets.
Web Search Brave fits situations like: you need web search results with country/language targeting; time-based filtering.
Run `npx skills add jwynia/agent-skills --skill web-search-brave -a claude-code`. Or copy the skill folder (skills/general/research/tools/web-search-brave in jwynia/agent-skills) into .claude/skills/web-search-brave in your project. Claude Code loads it when a task matches its description.
Run `npx skills add jwynia/agent-skills --skill web-search-brave -a codex`. Or copy the skill folder (skills/general/research/tools/web-search-brave in jwynia/agent-skills) into .agents/skills/web-search-brave in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jwynia/agent-skills --skill web-search-brave -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-brave, .gemini/skills/web-search-brave, .github/skills/web-search-brave and .opencode/skills/web-search-brave in your project.
Going by SKILL.md and its folder, Web Search Brave needs TypeScript for the scripts in its folder, the command-line tools its instructions call (deno) and credentials named BRAVE_API_KEY. Our summary lists: Node.js; A credential in BRAVE_API_KEY. Compatibility (from SKILL.md): Requires BRAVE_API_KEY environment variable and internet access.
SKILL.md names 2 domains. In commands or code: react.dev; the agent is likely to contact it when it follows the instructions. As links in the text: brave.com. This is read from the text; nothing was executed.
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.
Web Search Brave is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
About 2k tokens (SKILL.md is roughly 8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Web Search Brave: Brave Search (badlogic/pi-skills, 2.6k stars), Web Search (tmustier/pi-for-excel, 434 stars), Brave Search (LeoYeAI/openclaw-master-skills, 2.2k stars) and Brave Search (Anil-matcha/awesome-muse-connectors, 1.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
jwynia (a GitHub user) maintains it in jwynia/agent-skills, which has 170 GitHub stars. The repository holds 111 skills in this directory. The repository was last updated on February 24, 2026.
Source: jwynia/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.