Searches the web and fetches AI-generated summarized answers using the Brave Search API. Exposes two commands:
-
Trigger: Activate when the user wants to look something up on the web, check recent news, or get a factual answer to a question.
-
Setup: No installation step is required — this skill has zero external dependencies and runs on native Node.js.
-
Command selection:
- Use
brave-search
for general web searches where ranked results with URLs and snippets are useful.
- Use
brave-answer
for direct factual questions where a concise AI summary is more appropriate.
-
Execution: Invoke the script by passing the command name and parameters as separate arguments, never by interpolating user input into a shell command string. Use an argument array /
execFile
-style invocation so the shell never parses user-supplied values. Example (Node-style pseudo-code):
execFile('node', ['index.js', 'brave-search', '--query', userQuery, '--count', '10'])
Do not construct the command as a single concatenated string such as
"node index.js brave-search --query " + userQuery
.
-
Freshness: For time-sensitive queries, pass
--freshness
followed by pd
(past day), pw
(past week), or pm
(past month) as a separate argument to brave-search
.
-
Fallback: If
brave-answer
returns answer: null
, present the fallback_results
to the user instead.
-
Completion: Present the results clearly, citing titles and URLs for web search results, or the summary text for answer results.
