MCPInstall

searching-context

by volcengine

Search memories and resource context from OpenViking, aka. ov. Trigger this tool when 1. sees keyword "ovs"; 2. is explicitly requested searching files or knowledge; 3. sees search context request

Installs
56
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/volcengine/openviking --skill searching-context
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads searching-context automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

OpenViking (OV) context searching

The ov search command performs context-aware retrieval across all memories and resources in OpenViking — combining semantic understanding with directory recursive retrieval to find the most relevant context for any query.

Table of Content

  • When to Use
  • Search Modes
    • Context-Aware Search (ov search)
    • Content Pattern Search (ov grep)
    • File Glob Search (ov glob)
  • Search Options
    • Result Control
    • Scope Control
    • Session-Aware Search
  • Output
  • Other Utilities
    • List Contents (ov ls)
    • Tree View (ov tree)
    • Read File Content (ov read)
  • Agent Best Practices
    • Choosing Search Methods
    • Query Formulation
    • Combining with Other Commands
  • Prerequisite

When to Use

  • Finding specific information within imported resources or saved memories
  • Retrieving context about topics, APIs, or patterns previously added
  • Searching across project documentation, code, and learnings
  • When an agent needs to reference previously stored knowledge

note: cli command can be outdated, when sees error, use --help to get latest usage

Search Modes

Context-Aware Search (ov search)

Primary search method with session context awareness:

# Basic search across all context
ov search "how to handle API rate limits"

# Search within specific URI scope
ov search "authentication flow" --uri "viking://resources/my-project"

# Limit results and set threshold
ov search "error handling" --limit 5 --threshold 0.7

Content Pattern Search (ov grep)

Literal pattern matching:

# Search for exact text pattern
ov grep "viking://resources" "TODO:"

# Case-insensitive search
ov grep "viking://resources" "API_KEY" --ignore-case

File Glob Search (ov glob)

File path pattern matching:

# Find all markdown files
ov glob "**/*.md"

# Find Python files in specific directory
ov glob --uri="viking://user/" "**/*.md"

Search Options

Result Control

# Limit number of results
ov search "authentication" --limit 5

# Set minimum relevance threshold (0.0-1.0)
ov search "deployment" --threshold 0.8

# Combine limit and threshold
ov search "monitoring" --limit 10 --threshold 0.7

Scope Control

# Search specific directory
ov search "API design" --uri "viking://resources/xxx"

# Search within memories
ov search "user habits" --uri "viking://user/memories"

Session-Aware Search

# Search with session context (uses conversation history for better retrieval)
ov search "previous decision" --session-id "session-abc123"

Output

Returns a ranked list of matching resources with relevance scores:

URI: viking://resources/docs/api.md
Score: 0.8523
Abstract: API endpoints for user authentication...

URI: viking://user/memories/preferences
Score: 0.7891
Abstract: User prefers dark mode and compact layout...

Other Utilities

List Contents (ov ls)

Browse directory structure:

# List root directory
ov ls

# List specific directory
ov ls viking://resources/my-project

# Simple path output (for scripts)
ov ls viking://resources --simple

# Recursive listing
ov ls viking://resources --recursive

# Show hidden files
ov ls viking://resources --all

# Control output limits
ov ls viking://resources --node-limit 50 --abs-limit 128

Tree View (ov tree)

Visualize directory hierarchy:

# Show tree structure
ov tree viking://resources

# Control depth and limits
ov tree viking://resources --node-limit 100 --abs-limit 128

# Show all files including hidden
ov tree viking://resources --all

Read File Content (ov read)

Retrieve full content (L2 layer):

# Read full content
ov read viking://resources/docs/api.md

# Read abstract (L0 - quick summary)
ov abstract viking://resources/docs/api.md

# Read overview (L1 - key points)
ov overview viking://resources/docs/api.md

Agent Best Practices

Choosing Search Methods

  • ov search — Default choice. Context-aware, combines semantic + directory recursive retrieval
  • ov grep — Exact text pattern matching (like grep command)
  • ov glob — File path pattern matching (like shell glob)

Query Formulation

Write specific, contextual queries:

# Too vague
ov search "API"

# Better
ov search "REST API authentication with JWT tokens"

# Even better with scope
ov search "JWT token refresh flow" --uri "viking://resources/backend"

Combining with Other Commands

Use search results to guide further actions:

ov ls viking://resources/

# Search for relevant files
ov search "authentication" --uri "viking://resources/xxx"

# Then read specific content
ov read viking://resources/backend/auth.md

# Or get overview for context
ov overview viking://resources/backend

Prerequisites

  • CLI configured: ~/.openviking/ovcli.conf
  • Resources or memories previously added to OpenViking

FAQ

What does the searching-context skill do?

Search memories and resource context from OpenViking, aka. ov. Trigger this tool when 1. sees keyword "ovs"; 2. is explicitly requested searching files or knowledge; 3. sees search context request

How do I install searching-context?

Run npx skills add https://github.com/volcengine/openviking --skill searching-context in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/searching-context/ (personal) or .claude/skills/searching-context/ (project).

Which AI agents can use searching-context?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is searching-context safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains searching-context?

It is published by volcengine in volcengine/openviking. It has 56 recorded installs.

More from volcengine/openviking

View all →

openviking

volcengine/openviking

Activate when the user asks about any repository listed in the system prompt under 'OpenViking — Indexed Code Repositories', or when they ask about an external library, framework, or project that may have been indexed. Also activate when the user wants to add, remove, or manage repos. Always search the local codebase first before using this skill.

AI & Agents895 installs

ov-experience-memory

volcengine/openviking

Retrieve and apply OpenViking Experience memories through the Agent runtime's generic OpenViking search and read tools. Use before or during executable, multi-step, or tool-based work such as coding, file or data changes, configuration, deployment, workflow execution, and failure recovery when prior operational guidance could improve reliability. Do not use for casual chat or simple factual questions.

DevOps & Cloud580 installs

openviking-memory

volcengine/openviking

Recall and persist long-term memory through the OpenViking MCP tools. Use at the start of any substantive task (coding, configuration, debugging, multi-step or tool-based work) to retrieve relevant prior knowledge with find/search/read, and during or after work to persist durable facts, preferences, decisions, and lessons with remember. Do not use for casual chat or simple factual questions the model can answer directly.

AI & Agents507 installs

cron

volcengine/openviking

Open the skill to read its SKILL.md instructions.

216 installs

memory-recall

volcengine/openviking

Open the skill to read its SKILL.md instructions.

206 installs

github-proxy

volcengine/openviking

GitHub 国内访问加速 skill，使用 githubproxy.cc 代理加速 GitHub 仓库克隆、文件下载、Raw 文件访问等操作。使用场景：(1) 需要 git clone GitHub 仓库时加速，(2) 下载 GitHub Release 文件、Raw 文件、Archive 压缩包时加速，(3) 任何需要访问 GitHub 资源但速度慢的场景

Code Quality & Workflow170 installs

Popular other skills

View category →

hyperframes-cli

heygen-com/hyperframes

The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.

1.3M installs

triage

mattpocock/skills

Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.

1M installs

ask-matt

mattpocock/skills

Ask which skill or flow fits your situation. A router over the skills in this repo.

778.4K installs

to-questionnaire

mattpocock/skills

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

508.9K installs

wait-what

mattpocock/skills

Stop. That last message did not land: re-pitch it.

459.7K installs

loop-me

mattpocock/skills

Grill me about specs for the workflows I want to build, within this workspace.

447.9K installs