native-web-search — Claude Code skill: research with web search
native-web-search — a skill that runs a fast model with built-in web search and returns a concise summary with full source URLs. Useful when you need current information while coding.
Apache-2.0 134 installs ★ 3,224 updated 2026-09-27
npx skills add mitsuhiko/agent-stuff --skill native-web-search -a claude-codeWhat native-web-search does
The skill enables your agent to search the web and gather information tied to a specific purpose. It runs search.mjs, which sends a web-search query to the model, processes the response, and formats results: a brief summary plus full URLs for each key finding, including notes on disagreements between sources.
Requires Node.js in your environment. You can optionally select a provider (--provider openai-codex|anthropic), specify a model (--model), set a timeout (--timeout), or request JSON output (--json). If module resolution fails, the script looks for PI_AI_MODULE_PATH and PI_AI_OAUTH_MODULE_PATH environment variables; for OAuth providers, it can fall back to a cached token stored in ~/.pi/agent/auth.json.
What it helps with
- find current information about language and library releases
- compile breaking changes before upgrading a dependency
- verify documentation and best practices on a topic
- compare data across multiple sources in one summary
Example prompts for the agent
- What are the key features in the latest Python release?
- Get breaking changes for migrating to Vite 7 — I need a migration checklist
- Show me current best practices for authentication in Node.js apps
How to install native-web-search
1Skills CLI (Vercel)
npx skills add mitsuhiko/agent-stuff --skill native-web-search -a claude-code2Manually: put the files in place
~/.claude/skills/native-web-search/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/native-web-search/
1Skills CLI (Vercel)
npx skills add mitsuhiko/agent-stuff --skill native-web-search -a codex2Manually: put the files in place
.agents/skills/native-web-search/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add mitsuhiko/agent-stuff --skill native-web-search -a cursor2Manually: put the files in place
.cursor/skills/native-web-search/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install mitsuhiko/agent-stuff skills/native-web-search2Manually: put the files in place
.github/skills/native-web-search/SKILL.md1Skills CLI (Vercel)
npx skills add mitsuhiko/agent-stuff --skill native-web-search -a gemini-cli2Platform CLI
gemini skills install https://github.com/mitsuhiko/agent-stuff --path skills/native-web-searchManually: put the files in place
.devin/skills/native-web-search/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add mitsuhiko/agent-stuff --skill native-web-search -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about native-web-search
How do I install native-web-search in Claude Code?
Run npx skills add mitsuhiko/agent-stuff --skill native-web-search -a claude-code in your terminal, then open ~/.claude/skills/native-web-search/SKILL.md and follow the instructions.
What does native-web-search do?
It enables web search in model requests, gathers results with full source URLs, and highlights when sources disagree on a topic.
What dependencies does it need?
Only Node.js and npm. Dependencies are pulled automatically; if module resolution fails, set the PI_AI_MODULE_PATH and PI_AI_OAUTH_MODULE_PATH environment variables.
Source text
SKILL.md · Apache-2.0
--- name: native-web-search description: "Trigger native web search. Use when you need quick internet research with concise summaries and full source URLs." --- # Native Web Search Use this skill to run a **fast model with native web search enabled** and get a concise research summary with explicit full URLs. ## Script - `search.mjs` ## Usage Run from this skill directory: ```bash node search.mjs "<what to search>" --purpose "<why you need this>" ``` Examples: ```bash node search.mjs "latest python release" --purpose "update dependency notes" node search.mjs "vite 7 breaking changes" --purpose "prepare migration checklist" ``` Optional flags: - `--provider openai-codex|anthropic` - `--model <model-id>` - `--timeout <ms>` - `--json` ## Output expectations The script instructs the model to: - search the internet for the requested topic - provide a concise summary for the given purpose - include full canonical URLs (`https://...`) for each key finding - highlight disagreements between sources ## Notes - No extra npm install is required. - If module resolution fails, set `PI_AI_MODULE_PATH` to `@earendil-works/pi-ai`'s `dist/index.js` path. - If OAuth helper resolution fails, set `PI_AI_OAUTH_MODULE_PATH` to `@earendil-works/pi-ai`'s `dist/oauth.js` path. - For OAuth providers, the script can fall back to a still-valid cached `access` token from `~/.pi/agent/auth.json`.
© mitsuhiko · Apache-2.0 · mitsuhiko/agent-stuff