mcpField
A
adding-resource

adding-resource

github.com/volcengineData & databases41.1k52 installsUpdated today
Repository

About adding-resource

A skill for importing local files, directories, URLs, and remote repositories into OpenViking’s context database. It supports metadata and optional waiting for semantic processing, for agents or users building persistent reference collections.

Key features

  1. 01Import files, directories, URLs, and repositories
  2. 02Guide processing with reasons and instructions
  3. 03Wait for processing with an optional timeout
  4. 04Return the imported resource URI

Use cases

  1. 01Add project documentation for later retrieval
  2. 02Import web articles into a reference collection
  3. 03Persist useful content across agent sessions

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/volcengine/openviking --skill adding-resource

After installing, type/adding-resourcein Claude Code to confirm it loaded.

Details

From the project README

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:

# 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:

# 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:

# 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

Comments

Markdown supported