Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add mitsuhiko/agent-stuff --skill native-web-search -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/native-web-search/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/native-web-search/

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

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set16

The whole set →

Project sponsors

Companies that keep this analytics open