Skip to main content
GET
/
api
/
v1
/
fs
/
ls?uri=viking:
/
agent
/
skills
List Skills
curl --request GET \
  --url 'https://api.example.com/api/v1/fs/ls?uri=viking%3A%2F%2Fagent%2Fskills%2F'
{
  "status": "ok",
  "result": [
    {
      "name": "search-web",
      "uri": "viking://agent/skills/search-web/",
      "type": "directory"
    },
    {
      "name": "calculator",
      "uri": "viking://agent/skills/calculator/",
      "type": "directory"
    },
    {
      "name": "code-runner",
      "uri": "viking://agent/skills/code-runner/",
      "type": "directory"
    }
  ],
  "time": 0.05
}

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/volcengine/OpenViking/llms.txt

Use this file to discover all available pages before exploring further.

List all available skills in the knowledge base. Skills can be invoked by agents to perform specific tasks.
Skills are stored at viking://agent/skills/ in the Agent General File System (AGFS).

​
Authentication

Requires API key authentication via X-API-Key header.

​
Query Parameters

​
uri
string
required
The URI to list. Use viking://agent/skills/ to list all skills.
​
simple
boolean
default:"false"
If true, returns only skill names. If false, returns full metadata.

​
Response

​
status
string
Response status (ok or error)
​
result
array
Array of skills with metadata
​
time
number
Request processing time in seconds

​
Example

curl -X GET "http://localhost:1933/api/v1/fs/ls?uri=viking://agent/skills/" \
  -H "X-API-Key: your-key"

{
  "status": "ok",
  "result": [
    {
      "name": "search-web",
      "uri": "viking://agent/skills/search-web/",
      "type": "directory"
    },
    {
      "name": "calculator",
      "uri": "viking://agent/skills/calculator/",
      "type": "directory"
    },
    {
      "name": "code-runner",
      "uri": "viking://agent/skills/code-runner/",
      "type": "directory"
    }
  ],
  "time": 0.05
}

​
Skill Storage Structure

Each skill is stored as a directory containing:
  • .abstract.md - L0: Brief description
  • .overview.md - L1: Parameters and usage
  • SKILL.md - L2: Full documentation
  • Auxiliary files - Any additional resources

​
Reading Skill Content

After listing skills, use the content API to read skill documentation at different levels: 
uri = "viking://agent/skills/search-web/"

# L0: Brief description
abstract = client.abstract(uri)

# L1: Parameters and usage overview
overview = client.overview(uri)

# L2: Full skill documentation
content = client.read(uri)

Build docs developers (and LLMs) love

Get started for freeTalk to us