nathankoerschner/brave-search
agents/dot-agents/skills/brave-search/SKILL.md
Web search and content extraction via Brave Search API. Use for searching documentation, facts, or any web content. Lightweight, no browser required.
development
Updated May 31, 2026
$ install --global
skillsauthnpx skillsauth add nathankoerschner/dotfiles brave-searchInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 4, 2026, 7:36 PM4.3s4 files scanned
SKILL.md
- 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 (
~/.profileor~/.zprofilefor zsh):export BRAVE_API_KEY="your-api-key-here" - Install dependencies (run once):
cd {baseDir} npm install
Search
{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 weekpm- Past monthpy- Past yearYYYY-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
Related Skills
nathankoerschner/simplify
development
VerifiedTrustedCommunity
Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Use when asked to simplify, refactor lightly, clean up, or improve recently modified code without behavior changes.
SKILL.mdUpdated Jun 12, 2026
nathankoerschner/handoff
tools
VerifiedTrustedCommunity
Write a path-free, clipboard-ready handoff prompt that lets another agent investigate, discuss, or pick up a specific task.
SKILL.mdUpdated Jun 12, 2026
nathankoerschner/grill-me
testing
VerifiedTrustedCommunity
Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".
SKILL.mdUpdated Jun 12, 2026
nathankoerschner/autoreview
development
VerifiedTrustedCommunity
Run a Pi-based structured code review as a closeout check on local, branch, PR, or commit changes before commit or ship.
SKILL.mdUpdated Jun 10, 2026