adding-resource

Original：🇺🇸 English

Translated

Add resources to OpenViking, aka. ov. Use when an agent needs to add files, URLs, or external knowledge during interactions. Trigger this tool when 1. sees keyword "ovr"; 2. is explicitly requested adding files or knowledge; 3. identifies valuable resources worth importing

2installs

Sourcevolcengine/openviking

Added on2026-02-25

NPX Install

npx skill4agent add volcengine/openviking adding-resource

SKILL.md Content

View Translation Comparison →

OpenViking (OV)

add-resource

The

ov add-resource

command imports external resources into OpenViking's context database — supporting local files, directories, URLs, and remote repositories. Resources are automatically processed with semantic analysis and organized under the

viking://resources/

namespace.

When to Use

Importing project documentation, code repositories, or reference materials
Adding web pages, articles, or online resources for future retrieval
Building a knowledge base from external sources
When an agent encounters valuable content that should persist across sessions

Input Options

Basic Usage

Import a local file or URL:

bash

# Import from URL
ov add-resource https://raw.githubusercontent.com/volcengine/OpenViking/main/README.md

# Import local file
ov add-resource ./docs/api-spec.md

# Import local directory
ov add-resource ./project-source

Context and Instructions

Add metadata to guide processing:

bash

# Provide reason for import
ov add-resource ./api-docs.md --reason "REST API documentation for v2 endpoints"

# Add processing instructions
ov add-resource ./large-repo --instruction "Focus on authentication and authorization patterns"

# Combine reason and instruction
ov add-resource https://example.com/guide --reason "User guide" --instruction "Extract best practices and examples"

Async Processing Control

Wait for semantic processing to complete:

bash

# Wait until processing finishes
ov add-resource ./docs --wait

# Wait with timeout (in seconds)
ov add-resource https://example.com/docs --wait --timeout 60

# Fire and forget (default)
ov add-resource ./docs

Output

Returns the root URI of the imported resource:

root_uri  viking://resources/...

Prerequisites

CLI configured:
```
~/.openviking/ovcli.conf
```
Network access for URL imports
Read permissions for local files/directories

adding-resource

NPX Install

Tags

SKILL.md Content

OpenViking (OV)
`add-resource`

When to Use

Input Options

Basic Usage

Context and Instructions

Async Processing Control

Output

Prerequisites