feat(skills): add media/transcription helpers

skills/brave-search/SKILL.md

@@ -1,35 +1,29 @@
 ---
 name: brave-search
 description: Web search and content extraction via Brave Search API.
-metadata: {"clawdis":{"requires":{"bins":["node","npm"],"env":["BRAVE_API_KEY"]},"primaryEnv":"BRAVE_API_KEY","install":[{"id":"node-brew","kind":"brew","formula":"node","bins":["node","npm"],"label":"Install Node.js (brew)"}]}}
+metadata: {"clawdis":{"requires":{"bins":["node"],"env":["BRAVE_API_KEY"]},"primaryEnv":"BRAVE_API_KEY"}}
 ---
 
 # Brave Search
 
-Headless web search and content extraction using Brave Search. No browser required.
-
-## Setup (run once)
-
-```bash
-cd ~/Projects/agent-scripts/skills/brave-search
-npm ci
-```
-
-Needs env: `BRAVE_API_KEY`.
+Headless web search (and lightweight content extraction) using Brave Search API. No browser required.
 
 ## Search
 
 ```bash
-./search.js "query"                    # Basic search (5 results)
-./search.js "query" -n 10              # More results
-./search.js "query" --content          # Include page content as markdown
-./search.js "query" -n 3 --content     # Combined
+node {baseDir}/scripts/search.mjs "query"
+node {baseDir}/scripts/search.mjs "query" -n 10
+node {baseDir}/scripts/search.mjs "query" --content
+node {baseDir}/scripts/search.mjs "query" -n 3 --content
 ```
 
-## Extract Page Content
+## Extract a page
 
 ```bash
-./content.js https://example.com/article
+node {baseDir}/scripts/content.mjs "https://example.com/article"
 ```
 
-Fetches a URL and extracts readable content as markdown.
+Notes:
+- Needs `BRAVE_API_KEY`.
+- Content extraction is best-effort (good for articles; not for app-like sites).
+ - If a site is blocked or too JS-heavy, prefer the `summarize` skill (it can use a Firecrawl fallback).