vs-search

A guide for checking and troubleshooting search requests and the scenes that control how an application searches. Here, a scene is a saved search configuration, while runtime settings apply only to one request.

In plain words
What is it for?
Use it to verify queries, inspect or update search scenes, check online results, diagnose recall and ranking issues, and update detailed serving controls. It requires an application ID and may require a scene ID for edits.
Why use it?
It helps separate permanent search-configuration problems from temporary request settings. It also helps explain why results are missing, ranked unexpectedly, or unavailable because the application is not ready.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/volcengine/searchcli/vs-search
Any agent
npx skills add volcengine/SearchCLI --skill vs-search
Clone the repo
git clone --depth 1 https://github.com/volcengine/SearchCLI

Made for: Claude Code, Codex.

Per session 27 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,306 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00027 $0.01306
Opus 5 $0.00014 $0.00653
Sonnet 5 $0.00005 $0.00261
Haiku 4.5 $0.00003 $0.00131

Measured 2d ago against content hash 5d341e772fcc, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

vs-search scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/vs-search/SKILL.md · 89 lines

How it starts

The opening of the file, as written. The whole thing — 89 lines — stays where its author put it; the contents beside it link to each section on GitHub.

When to Use

Use this skill for:

  • search query verification
  • search scene inspection and updates
  • online result checks
  • recall or ranking issue diagnosis
  • separating persistent scene config from request-only runtime parameters
  • fine-grained operations / serving-controls updates, including query-specific search rules

If the user wants automated batch evaluation or similarity tuning across many queries and strategies, use vs-search-tuning instead.

Preconditions

  • an application-id is available
  • if you will edit a scene, you should preferably know the scene-id
  • for fresh apps, be prepared for the runtime not to be ready yet
  • the agent should treat the installed CLI behavior as authoritative when help text, skill text, and runtime behavior disagree

Scope

Before changing anything, decide whether the user wants:

  • a persistent search strategy change
  • a temporary runtime verification
  • a readiness diagnosis for a failing app

This skill stays at the search workflow level. Do not embed low-level API field mappings, payload design, or enum interpretation here. When a concrete command needs exact parameters, first consult vs-product-qa.

Commands

  • search run: send a production-style search request
  • search scene create / search scene list / search scene get: manage search scenes
  • search scene update: update scene configuration
  • app status / app diagnose: inspect readiness before blaming the query

Workflow

  1. Start by determining whether the user wants:
    • a persistent search strategy change
    • a temporary runtime verification
    • a readiness diagnosis for a failing app
  2. If the request is a persistent search strategy change, use search scene list/get first and inspect the current scene before mutating it.
  3. Before running any concrete command, consult vs-product-qa to confirm the current command behavior and the exact parameter requirements.
  4. Use search run for verification requests and search scene update for persistent scene changes.
  5. After every scene mutation, immediately read the scene back with search scene get and verify that the intended change is visible online.
  6. If a fresh app fails, check app status and then app diagnose.
  7. Only after readiness is clear should you focus on recall quality or scene configuration.
  8. If the command behavior conflicts with the skill text or --help, trust the installed CLI behavior first, and only then inspect repository code when needed to explain or fix the gap.

Read the full file on GitHub · 89 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 89 lines · 27 tokens per session scan A 5d341e772fcc

Subscribe to this mod's changes

vs-search is a skill published in the GitHub repository volcengine/SearchCLI (1,175 stars, last pushed 6d ago), licensed Apache-2.0. It adds 27 tokens to every session and 1,306 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

xerj-code

Reference-coding with XERJ. Clone the libraries that already solved your problem, index them locally, and retrieve the exact implementation before writing code — so the agent reads passages instead of re-deriving algorithms across retry loops. Use when starting a task in an unfamiliar API, porting an algorithm, or…

xerj-org/xerj · 79 tokens

xerj-security-audit

Coverage-guaranteed whitebox security audit of a codebase using XERJ + tree-sitter AST. Use when the user wants to security-review PHP (or other-language) code with a provable "we enumerated every dangerous call" guarantee, or asks to run the WordPress-style sink census / audit. Drives an index-once, query-read-reason…

xerj-org/xerj · 97 tokens

linkly-ai

Search, browse, read, and take notes across the user's documents indexed by Linkly AI — local files and linked cloud libraries. Use when the user asks to 'search my documents', 'find files about a topic', 'read a local document', 'what's in this folder', 'list the files in that library', 'browse document outlines'…

LinklyAI/linkly-ai-skills · 221 tokens

youtube-content

YouTube Data API — search, video details, channel info, transcripts.

furkangonel/cowrangler · 18 tokens

zero-api-key-web-search

OpenClaw skill for source-backed web search, page reading, and evidence-aware claim checking. No API keys required by default; optional providers can be enabled for stronger coverage. v23: multi-engine SERP (7 engines), Web Unlocker for blocked pages, auto-fallback on 403/429.

wd041216-bit/zero-api-key-web-search · 68 tokens

zero-api-key-web-search

Claude Code-compatible skill for source-backed web search, page reading, and evidence-aware claim checking. Use it when an answer depends on current facts, live sources, or explicit support/conflict handling. v23: multi-engine SERP (7 engines), Web Unlocker for blocked pages, auto-fallback on 403/429.

wd041216-bit/zero-api-key-web-search · 72 tokens