Agent skill

Brave Search

Web search and content extraction via Brave Search API. An agent skill from badlogic/pi-skills.

MITAuto-check passedProductivity & Automation

Install Brave Search

skills CLI

$ npx skills add badlogic/pi-skills --skill brave-search -a claude-code

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

GitHub CLI

$ gh skill install badlogic/pi-skills brave-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/badlogic/pi-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/brave-search .claude/skills/brave-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/

Paste into Claude Code

Install the "brave-search" agent skill from https://github.com/badlogic/pi-skills/tree/main/brave-search into .claude/skills/brave-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brave-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.

$skill-installer

$skill-installer install https://github.com/badlogic/pi-skills/tree/main/brave-search

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

skills CLI

$ npx skills add badlogic/pi-skills --skill brave-search -a codex

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

GitHub CLI

$ gh skill install badlogic/pi-skills brave-search --agent codex

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

Manual copy

$ git clone --depth 1 https://github.com/badlogic/pi-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/brave-search .agents/skills/brave-search && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

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

Paste into Codex

Install the "brave-search" agent skill from https://github.com/badlogic/pi-skills/tree/main/brave-search into .agents/skills/brave-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brave-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 badlogic/pi-skills --skill brave-search -a cursor

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

GitHub CLI

$ gh skill install badlogic/pi-skills brave-search --agent cursor

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

Manual copy

$ git clone --depth 1 https://github.com/badlogic/pi-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/brave-search .cursor/skills/brave-search && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

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

Paste into Cursor

Install the "brave-search" agent skill from https://github.com/badlogic/pi-skills/tree/main/brave-search into .cursor/skills/brave-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brave-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.

gemini skills install

$ gemini skills install https://github.com/badlogic/pi-skills.git --path brave-search

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add badlogic/pi-skills --skill brave-search -a gemini-cli

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

GitHub CLI

$ gh skill install badlogic/pi-skills brave-search --agent gemini-cli

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

Manual copy

$ git clone --depth 1 https://github.com/badlogic/pi-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/brave-search .gemini/skills/brave-search && rm -rf skills-src

Use ~/.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/

Paste into Gemini CLI

Install the "brave-search" agent skill from https://github.com/badlogic/pi-skills/tree/main/brave-search into .gemini/skills/brave-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brave-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 badlogic/pi-skills brave-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 badlogic/pi-skills --skill brave-search -a github-copilot

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

Manual copy

$ git clone --depth 1 https://github.com/badlogic/pi-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/brave-search .github/skills/brave-search && rm -rf skills-src

Use ~/.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/

Paste into GitHub Copilot

Install the "brave-search" agent skill from https://github.com/badlogic/pi-skills/tree/main/brave-search into .github/skills/brave-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brave-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 badlogic/pi-skills --skill brave-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 badlogic/pi-skills brave-search --agent opencode

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

Manual copy

$ git clone --depth 1 https://github.com/badlogic/pi-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/brave-search .opencode/skills/brave-search && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

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

Paste into OpenCode

Install the "brave-search" agent skill from https://github.com/badlogic/pi-skills/tree/main/brave-search into .opencode/skills/brave-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brave-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: brave-search
GitHub stars: 2.6k
Used in: 5 other repos
Token cost: ~592 tokens
SKILL.md length: 168 words
Files: 6
Skills in repo: 6
Repo updated: Jun 6, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Web search and content extraction via Brave Search API. An agent skill from badlogic/pi-skills.

Works in 5 steps: Create an account at… → Create a "Free AI" subscription → Create an API key for the subscription → …
Searching documentation
SKILL.md covers Setup, Search, Extract Page Content and Output Format, plus 1 more section
Runs JavaScript scripts from its folder; calls npm; needs BRAVE_API_KEY

What it does

Brave Search is an agent skill from badlogic/pi-skills. Web search and content extraction via Brave Search API. Use for searching documentation, facts, or any web content. Lightweight, no browser required.

Its SKILL.md is about 590 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files (for example `content.js`, `package-lock.json` and `package.json`).

It sits in Productivity & Automation, covering Web search. It works with Brave Search API. The repository describes itself as: Skills for pi coding agent (compatible with Claude Code and Codex CLI). The licence is MIT.

When your agent uses it

Searching documentation
Any web content

Example prompts

“/brave-search”

Requirements

Node.js
A credential in BRAVE_API_KEY

Workflow steps

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

Create an account at https://api-dashboard.search.brave.com/register
Create a "Free AI" subscription
Create an API key for the subscription
Add to your shell profile (~/.profile or ~/.zprofile for zsh)
Install dependencies (run once)

What it can do on your machine

Read from SKILL.md and the folder at commit 90bb51c. 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 script files (JavaScript), which the agent can run.
Shell commands in SKILL.md call:
- npm
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):
- api-dashboard.search.brave.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- BRAVE_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Brave Search loads about 592 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 168 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from badlogic/pi-skills at commit 90bb51c, republished under its MIT licence (© badlogic). 168 words, ~592 tokens.

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

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

Brave Search

Web search and content extraction using the official Brave Search API. No browser required.

Setup

Requires a Brave Search API account with a free subscription. A credit card is required to create the free subscription (you won't be charged).

Create an account at https://api-dashboard.search.brave.com/register
Create a "Free AI" subscription
Create an API key for the subscription
Add to your shell profile (~/.profile or ~/.zprofile for zsh):
bash
```
export BRAVE_API_KEY="your-api-key-here"
```
Install dependencies (run once):
bash
```
cd {baseDir}
npm install
```

Search

bash

{baseDir}/search.js "query"                         # Basic search (5 results)
{baseDir}/search.js "query" -n 10                   # More results (max 20)
{baseDir}/search.js "query" --content               # Include page content as markdown
{baseDir}/search.js "query" --freshness pw          # Results from last week
{baseDir}/search.js "query" --freshness 2024-01-01to2024-06-30  # Date range
{baseDir}/search.js "query" --country DE            # Results from Germany
{baseDir}/search.js "query" -n 3 --content          # Combined options

Options

-n <num> - Number of results (default: 5, max: 20)
--content - Fetch and include page content as markdown
--country <code> - Two-letter country code (default: US)
--freshness <period> - Filter by time:
- pd - Past day (24 hours)
- pw - Past week
- pm - Past month
- py - Past year
- YYYY-MM-DDtoYYYY-MM-DD - Custom date range

Extract Page Content

bash

{baseDir}/content.js https://example.com/article

Fetches a URL and extracts readable content as markdown.

Output Format

--- Result 1 ---
Title: Page Title
Link: https://example.com/page
Age: 2 days ago
Snippet: Description from search results
Content: (if --content flag used)
  Markdown content extracted from the page...

--- Result 2 ---
...

When to Use

Searching for documentation or API references
Looking up facts or current information
Fetching content from specific URLs
Any task requiring web search without interactive browsing

Files

SKILL.md and 5 other files in brave-search of badlogic/pi-skills.

SKILL.md
.gitignore
content.js
package-lock.json
package.json
search.js

Open the folder on GitHubat commit 90bb51c

Used in 5 other repositories

We found 5 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 5 other GitHub owners. This page covers the copy in badlogic/pi-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

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

Brave Search compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Brave Search this skillbadlogic/pi-skills	2.6k	5 repos	~592	Automated safety check: Pass	MIT	4 mo ago
Web Searchtmustier/pi-for-excel	434	—	~410	Automated safety check: Pass	MIT	yesterday
Web Search Bravejwynia/agent-skills	170	—	~2k	Automated safety check: Pass	MIT	7 mo ago
Brave SearchLeoYeAI/openclaw-master-skills	2.2k	—	~4.6k	Automated safety check: Pass	MIT	2 mo ago
Brave SearchAnil-matcha/awesome-muse-connectors	1.3k	—	~440	Automated safety check: Pass	MIT	5 days ago
Qryma Searchaiskillstore/marketplace	433	—	~567	Automated safety check: Notes	MIT	today

Similar skills

Web Search
tmustier/pi-for-excel
Search the public web for up-to-date facts. An agent skill from tmustier/pi-for-excel.
434 GitHub stars~410 tokensUpdated yesterday
Productivity & AutomationAuto-check passed
Web Search Brave
jwynia/agent-skills
Search the web using Brave Search API for fast, privacy-respecting results with localization, freshness filtering, and extra snippets.
170 GitHub stars~2k tokensUpdated 7 mo ago
Productivity & AutomationAuto-check passed
Brave Search
LeoYeAI/openclaw-master-skills
Brave Search API integration with managed authentication. An agent skill from LeoYeAI/openclaw-master-skills.
2.2k GitHub stars~4.6k tokensUpdated 2 mo ago
Productivity & AutomationAuto-check passed
Brave Search
Anil-matcha/awesome-muse-connectors
Independent web search from Brave's own index. An agent skill from Anil-matcha/awesome-muse-connectors.
1.3k GitHub stars~440 tokensUpdated 5 days ago
Productivity & AutomationAuto-check passed
Qryma Search
aiskillstore/marketplace
Search the web with multiple output formats using the Qryma API.
433 GitHub stars~567 tokensUpdated today
Productivity & AutomationAuto-check: notes
9Router Web Search
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.
31k GitHub stars~1k tokensUpdated 2 days ago
Productivity & AutomationAuto-check passed

Questions about Brave Search

What does Brave Search do?

Web search and content extraction via Brave Search API. An agent skill from badlogic/pi-skills. Brave Search is an agent skill from badlogic/pi-skills. Web search and content extraction via Brave Search API.

When should I use Brave Search?

Brave Search fits situations like: searching documentation; any web content.

How do I install Brave Search in Claude Code?

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

How do I install Brave Search in Codex?

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

Can I use Brave 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 badlogic/pi-skills --skill brave-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/brave-search, .gemini/skills/brave-search, .github/skills/brave-search and .opencode/skills/brave-search in your project.

What does Brave Search need to run?

Going by SKILL.md and its folder, Brave Search needs JavaScript for the scripts in its folder, the command-line tools its instructions call (npm) and credentials named BRAVE_API_KEY. Our summary lists: Node.js; A credential in BRAVE_API_KEY.

Does Brave Search access the network?

SKILL.md names 1 domain. As links in the text: api-dashboard.search.brave.com. This is read from the text; nothing was executed.

Is Brave 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. Review the folder before installing.

What licence does Brave Search use?

Brave 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 Brave Search use?

About 592 tokens (SKILL.md is roughly 2.4k 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 Brave Search?

Skills that share tags, products or a category with Brave Search: Web Search (tmustier/pi-for-excel, 434 stars), Web Search Brave (jwynia/agent-skills, 170 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.

Who maintains Brave Search?

badlogic (a GitHub user) maintains it in badlogic/pi-skills, which has 2,596 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on June 6, 2026.

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

Install Brave 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

Brave Search

Setup

Search

Options

Extract Page Content

Output Format

When to Use

Files

Used in 5 other repositories

Compare with similar skills

Similar skills

More from badlogic/pi-skills

Related

Questions about Brave Search