About

Imported from kjuhwa/skills-hub (skills/integration/hosted-tools-web-search/SKILL.md). Install upstream with npx skills add kjuhwa/skills-hub --skill hosted-tools-web-search. Copyright stays with the author.

hosted-tools-web-search

Name: hosted-tools-web-search
Author: kjuhwa

Use WebSearchTool, FileSearchTool, or CodeInterpreterTool from agents package. These run on OpenAI's servers without your Python code handling the execution.

When to apply

When you need real-time web search, vector store retrieval, or sandboxed code execution without building and maintaining tool infrastructure.

Web search

from agents import Agent, Runner, WebSearchTool

agent = Agent(
    name="Web searcher",
    instructions="You are a helpful agent.",
    tools=[WebSearchTool(
        user_location={"type": "approximate", "city": "New York"},
        search_context_size="medium",  # "low" | "medium" | "high"
    )],
)
result = await Runner.run(agent, "What's the latest local sports news?")

File search (vector store)

from agents import Agent, FileSearchTool

agent = Agent(
    name="Research assistant",
    tools=[FileSearchTool(
        max_num_results=3,
        vector_store_ids=["vs_abc123"],
    )],
)

Code interpreter

from agents import Agent, CodeInterpreterTool

agent = Agent(
    name="Data analyst",
    model="gpt-4o",
    instructions="Use the code interpreter to solve numeric problems.",
    tools=[CodeInterpreterTool(
        tool_config={"type": "code_interpreter", "container": {"type": "auto"}},
    )],
)

Key notes

Hosted tools run server-side; your Python process is NOT called for each tool invocation
on_tool_start/end lifecycle hooks do NOT fire for hosted tools
WebSearchTool supports filters for domain inclusion/exclusion
FileSearchTool supports ranking_options and include_search_results
CodeInterpreterTool requires org verification for gpt-5 class models with streaming

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/kjuhwa-skills-hub-hosted-tools-web-search/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

kjuhwa-skills-hub-hosted-tools-web-search.ocm.jsonjson

{
  "ocm": "1",
  "id": "kjuhwa-skills-hub-hosted-tools-web-search",
  "kind": "skill",
  "name": "hosted-tools-web-search",
  "description": "Add hosted OpenAI tools (WebSearchTool, FileSearchTool, CodeInterpreterTool) to an agent.",
  "publisher": "kjuhwa",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "openai-agents",
      "web-search",
      "file-search",
      "code-interpreter",
      "hosted-tools",
      "github"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Add hosted OpenAI tools (WebSearchTool, FileSearchTool, CodeInterpreterTool) to an agent."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github",
      "repository": "https://github.com/kjuhwa/skills-hub",
      "path": "skills/integration/hosted-tools-web-search/SKILL.md",
      "ref": "b8e7275ea024cc3f9d8551b41aa9ebf89b464cd1",
      "url": "https://github.com/kjuhwa/skills-hub/blob/b8e7275ea024cc3f9d8551b41aa9ebf89b464cd1/skills/integration/hosted-tools-web-search/SKILL.md",
      "key": "kjuhwa/skills-hub/skills/integration/hosted-tools-web-search/SKILL.md"
    }
  },
  "instructions": "# hosted-tools-web-search\n\nUse `WebSearchTool`, `FileSearchTool`, or `CodeInterpreterTool` from `agents` package. These run on OpenAI's servers without your Python code handling the execution.\n\n## When to apply\n\nWhen you need real-time web search, vector store retrieval, or sandboxed code execution without building and maintaining tool infrastructure.\n\n## Web search\n\n```python\nfrom agents import Agent, Runner, WebSearchTool\n\nagent = Agent(\n    name=\"Web searcher\",\n    instructions=\"You are a helpful agent.\",\n    tools=[WebSearchTool(\n        user_location={\"type\": \"approximate\", \"city\": \"New Y",
  "cost": {
    "context_tokens": 435
  }
}

Fetch it by URL: GET /api/v1/registry/kjuhwa-skills-hub-hosted-tools-web-search/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.