openviking

SKILL.md

OpenViking Code Repository Search

IMPORTANT: All ov commands are terminal (shell) commands — run them via the bash tool. Execute directly — no pre-checks, no test commands. Handle errors when they occur.

How OpenViking Organizes Data

OpenViking stores content in a virtual filesystem under the viking:// namespace. Each URI maps to a file or directory, e.g. viking://resources/fastapi/routing.py. Each directory has AI-generated summaries (abstract / overview). The key principle: narrow the URI scope to improve retrieval efficiency. Instead of searching all repos, lock to a specific repo or subdirectory — this reduces noise and speeds up results significantly.

Search Commands

Choose the right command based on what you're looking for:

Command
Use when
Example

ov search
Semantic search — use for concept/intent based queries
"dependency injection", "how auth works"

ov grep
You know the exact keyword or symbol
function name, class name, error string

ov glob
You want to enumerate files by pattern
all *.py files, all test files