Skip to content
alyn
badlogic

Brave Search skill

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

$npx skills add badlogic/pi-skills --skill brave-search
View this skill on GitHubbadlogic/pi-skills/brave-search/SKILL.md
Pack stars
2,655
Pack installs
4.2k
Alyn Score
49/99
Updated
5 months ago
License
MIT
– views – installs via Alyn

badlogic

Brave Search

Writing

Install Brave Search

Pick your agent. Every command is ready to paste.

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

The open skills CLI detects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.

01

Install it

Run the command above, or upload the folder in Claude.

02

Ask naturally

Describe the task. Your agent loads brave-search when the request matches its description.

03

Name it if needed

If it does not trigger, say “use the brave-search skill”. In Codex, type $brave-search.

The skill itself

SKILL.md

FolderGitHub

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

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

{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

{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

Tips for Brave Search

  • • Start a fresh session after installing so your agent picks up the new skill.
  • • This skill ships scripts. Read them before the first run, and run it in a project without secrets first.
  • • It is part of a pack with 8 skills. Install only the ones you need with --skill to keep triggers precise.
  • • If two skills overlap, mention the one you want by name.

Questions about Brave Search

What does the Brave Search skill do?

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

How do I install Brave Search?

Run "npx skills add badlogic/pi-skills --skill brave-search" in your project. The skills CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.

Does Brave Search work in Cursor and Codex?

Yes. Brave Search uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.

Is Brave Search free?

Brave Search is open source on GitHub under the MIT license. It is free to install; check the license before commercial use.

Who made Brave Search?

Brave Search is published by badlogic in the badlogic/pi-skills repository, together with 7 other skills.

Similar skills. From other creators.