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

7installs
Sourcevolcengine/openviking
Added on

NPX Install

npx skill4agent add volcengine/openviking adding-resource

Tags

Translated version includes tags in frontmatter
openvikingadd-resourcecli-toolknowledge-managementresource-import

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