Agent skill

Web Search

by athola in athola/claude-night-market

Searches the open web for docs, comparisons, and news via You.com MCP or WebSearch.

MITAuto-check passedProductivity & Automation

Install Web Search

skills CLI
$ npx skills add athola/claude-night-market --skill web-search -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install athola/claude-night-market web-search --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/athola/claude-night-market.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/tome/skills/web-search .claude/skills/web-search && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
web-search
GitHub stars
341
Token cost
~829 tokens
SKILL.md length
380 words
Files
1
Skills in repo
154
Repo updated
First seen
Licence
MIT

At a glance

Searches the open web for docs, comparisons, and news via You.com MCP or WebSearch.

  • Works in 2 steps: You.com MCP server (you-search tool)… → WebSearch tool as fallback (no…
  • A topic needs knowledge beyond GitHub
  • SKILL.md covers When To Use, When NOT To Use, Sources (Priority Order) and Setup (Optional), plus 3 more sections
  • Calls claude; reaches api.you.com; needs YDC_API_KEY

What it does

Web Search is an agent skill from athola/claude-night-market. Searches the open web for docs, comparisons, and news via You.com MCP or WebSearch. Use when a topic needs knowledge beyond GitHub, forums, or academia.

Its SKILL.md is about 830 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation, covering Web search and MCP servers. It works with Model Context Protocol and GitHub. The repository describes itself as: 23 Claude Code plugins: TDD enforcement hooks, git/PR workflows, spec-driven development, code review, project lifecycle, fix-from-error, maintenance automation, context… The licence is MIT.

When your agent uses it

  • A topic needs knowledge beyond GitHub
  • Tasks that involve Web search
  • Tasks that involve MCP servers

Example prompts

  • “Use the web-search skill to search the open web for docs, comparisons, and news via You.com MCP or WebSearch”
  • “/web-search”

Requirements

  • A credential in YDC_API_KEY

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. You.com MCP server (you-search tool) when configured
  2. WebSearch tool as fallback (no configuration needed)

What it can do on your machine

Read from SKILL.md and the folder at commit 9f3eb00. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • claude

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.you.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • YDC_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Web Search loads about 829 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 380 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~829

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from athola/claude-night-market at commit 9f3eb00, republished under its MIT licence (© athola). 380 words, ~829 tokens.

Download SKILL.mdSave it as .claude/skills/web-search/SKILL.md (or your agent's skills folder).
name
web-search
description
Searches the open web for docs, comparisons, and news via You.com MCP or WebSearch. Use when a topic needs knowledge beyond GitHub, forums, or academia.
alwaysApply
false
category
research
tags
web, search, youcom, documentation
estimated_tokens
200
model_hint
standard

When To Use

  • Finding vendor documentation, standards, or official guides
  • Comparisons and benchmarks across products or approaches
  • News, release notes, and recent status for a technology
  • Standalone searches, or as one channel of a /tome:research session: the planner dispatches tome:web-searcher from medium depth, and the channel runs a positive control (RFC 2119) before its topic queries so its silence can count in the coverage verdict

When NOT To Use

  • Code implementations (use Skill(tome:code-search))
  • Community opinions (use Skill(tome:discourse))
  • Academic literature (use Skill(tome:papers))

Search the open web for pages about a topic. This is the general-knowledge channel: the pages no domain-specific channel targets.

Sources (Priority Order)

  1. You.com MCP server (you-search tool) when configured
  2. WebSearch tool as fallback (no configuration needed)

The You.com MCP server is optional. Without it the channel runs entirely on the built-in WebSearch tool, so a session never fails because the server is absent.

Setup (Optional)

To prefer You.com results, add the MCP server to your Claude Code config once:

bash
# Keyless free profile
claude mcp add you --transport http https://api.you.com/mcp?profile=free

# Authenticated (higher rate limits; YDC_API_KEY from you.com)
claude mcp add you --transport http https://api.you.com/mcp \
  --header "Authorization: Bearer $YDC_API_KEY"

A key is only needed for the authenticated endpoint. The free profile needs no key and no account.

Workflow

  1. Build search queries using tome.channels.web.expand_web_queries()
  2. Run each query through the You.com MCP you-search tool if the server is configured, otherwise through WebSearch
  3. Parse results via parse_you_mcp_result() (raises ValueError on a response shape that is not a you-search envelope) or parse_websearch_result() (raises ValueError on a result with no URL)
  4. Rank via rank_web_findings()
  5. Return Finding objects
Show full SKILL.md (137 more words)Show less

Failure Handling

  • If the You.com MCP tool errors or is unreachable, retry the query through WebSearch and record the fallback in the query log so the report can show the channel ran degraded rather than ok
  • If both paths fail for every query, report the failure explicitly rather than returning fabricated or empty findings

Exit Criteria

  • At least one web search query built and executed for the requested topic, through You.com MCP or WebSearch
  • Results parsed into Finding objects with title, URL, and a relevance score, marked channel="web"
  • Findings returned from rank_web_findings() sorted by relevance score descending
  • If the You.com path failed and WebSearch was used, the fallback is reported rather than passed off as the primary source
  • If no results are found for any query, this is reported explicitly rather than returning an empty list silently

© athola, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/tome/skills/web-search of athola/claude-night-market.

Open the folder on GitHubat commit 9f3eb00

Compare with similar skills

Web Search next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Web Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Web Search this skillathola/claude-night-market341—~829Automated safety check: PassMIT
MCP Managerclacky-ai/openclacky1.2k—~3kAutomated safety check: PassMIT
Dev MCP Setupevolution-foundation/evo-nexus545—~615Automated safety check: PassCustom licence
Glim MCPaeonfun/aeon767—~1.3kAutomated safety check: WarnMIT
ComposioComposioHQ/composio30k1 repos~1.7kAutomated safety check: PassMIT
Huge AI Searchwangwingzero/huge-ai-search144—~563Automated safety check: PassMIT

Similar skills

  • MCP Manager

    clacky-ai/openclacky

    Manage MCP (Model Context Protocol) servers for openclacky: add, list, probe, remove, reconfigure.

    1.2k GitHub stars~3k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Dev MCP Setup

    evolution-foundation/evo-nexus

    Configure MCP servers for the workspace — web search, filesystem, GitHub, Stripe, etc.

    545 GitHub stars~615 tokensUpdated 4 mo ago
    Agent WorkflowsAuto-check passed
  • Glim MCP

    aeonfun/aeon

    Live-data research via the glim.sh MCP - web search, full page extraction, X/Twitter, Reddit, GitHub, Amazon, and YouTube transcripts - synthesized into a cited digest.

    767 GitHub stars~1.3k tokensUpdated 2 days ago
    Knowledge ManagementAuto-check: warnings
  • Composio

    ComposioHQ/composio

    Route and complete Composio work across Composio For You and Composio Platform.

    30k GitHub starsUsed in 1 repo~1.7k tokens
    Productivity & AutomationAuto-check passed
  • Huge AI Search

    wangwingzero/huge-ai-search

    Searches the live web through Google AI Mode via Huge AI Search (MCP or CLI).

    144 GitHub stars~563 tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed
  • Mysearch

    skernelx/MySearch-Proxy

    DEFAULT search skill for OpenClaw. An agent skill from skernelx/MySearch-Proxy.

    159 GitHub stars~1.4k tokensUpdated 6 mo ago
    Productivity & AutomationAuto-check: notes

More from athola/claude-night-market

All 154 skills in this repo
  • Night Market Diagnostics Toolkit

    athola/claude-night-market

    Run and interpret repo diagnostic scripts (ratchets, validators, token stats).

    341 GitHub stars~3.4k tokensUpdated 3 days ago
    Auto-check passed
  • Skills Eval

    athola/claude-night-market

    Evaluate Claude skill quality through auditing. An agent skill from athola/claude-night-market.

    341 GitHub stars~1.6k tokensUpdated 3 days ago
    Auto-check passed
  • Agent Teams

    athola/claude-night-market

    Coordinates Claude agent teams via filesystem protocol. An agent skill from athola/claude-night-market.

    341 GitHub stars~2.5k tokensUpdated 3 days ago
    Auto-check passed
  • Delegation Core

    athola/claude-night-market

    Delegates execution to eight CLIs (Gemini, Qwen, MiniMax, GLM, Muse, Codex, OpenCode, Glimmer).

    341 GitHub stars~2.5k tokensUpdated 3 days ago
    Auto-check passed
  • Elegant Code

    athola/claude-night-market

    Guide minimal code via a decision ladder with full safety, edge, and negative-case coverage.

    341 GitHub stars~2.1k tokensUpdated 3 days ago
    Auto-check passed
  • Skill Library Mission

    athola/claude-night-market

    Build a project skill library in .claude/skills/ via discovery, parallel authoring, and review.

    341 GitHub stars~1.6k tokensUpdated 3 days ago
    Auto-check passed

Questions about Web Search

What does Web Search do?

Searches the open web for docs, comparisons, and news via You.com MCP or WebSearch. Web Search is an agent skill from athola/claude-night-market.com MCP or WebSearch.

When should I use Web Search?

Web Search fits situations like: A topic needs knowledge beyond GitHub; tasks that involve Web search; tasks that involve MCP servers.

How do I install Web Search in Claude Code?

Run `npx skills add athola/claude-night-market --skill web-search -a claude-code`. Or copy the skill folder (plugins/tome/skills/web-search in athola/claude-night-market) into .claude/skills/web-search in your project. Claude Code loads it when a task matches its description.

How do I install Web Search in Codex?

Run `npx skills add athola/claude-night-market --skill web-search -a codex`. Or copy the skill folder (plugins/tome/skills/web-search in athola/claude-night-market) into .agents/skills/web-search in your project. Codex loads it when a task matches its description.

Can I use Web Search in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add athola/claude-night-market --skill web-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/web-search, .gemini/skills/web-search, .github/skills/web-search and .opencode/skills/web-search in your project.

What does Web Search need to run?

Going by SKILL.md and its folder, Web Search needs the command-line tools its instructions call (claude) and credentials named YDC_API_KEY. Our summary lists: A credential in YDC_API_KEY.

Does Web Search access the network?

SKILL.md names 1 domain. In commands or code: api.you.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Web Search safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Web Search use?

Web Search is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Web Search use?

About 829 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Web Search?

Skills that share tags, products or a category with Web Search: MCP Manager (clacky-ai/openclacky, 1.2k stars), Dev MCP Setup (evolution-foundation/evo-nexus, 545 stars), Glim MCP (aeonfun/aeon, 767 stars) and Composio (ComposioHQ/composio, 30k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Web Search?

athola (a GitHub user) maintains it in athola/claude-night-market, which has 341 GitHub stars. The repository holds 154 skills in this directory. The repository was last updated on October 6, 2026.

Source: athola/claude-night-market on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.