List Skills

GET

api

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'

const options = {method: 'GET'};

fetch('https://api.example.com/api/v1/fs/ls?uri=viking%3A%2F%2Fagent%2Fskills%2F', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/fs/ls?uri=viking%3A%2F%2Fagent%2Fskills%2F",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/fs/ls?uri=viking%3A%2F%2Fagent%2Fskills%2F"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/fs/ls?uri=viking%3A%2F%2Fagent%2Fskills%2F")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "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
}

{
  "status": "ok",
  "result": [
    "search-web",
    "calculator",
    "code-runner"
  ],
  "time": 0.02
}

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

string

required

The URI to list. Use viking://agent/skills/ to list all skills.

boolean

default:"false"

If true, returns only skill names. If false, returns full metadata.

Response

string

Response status (ok or error)

array

Array of skills with metadata

Show Skill Object

string

Skill name in kebab-case (e.g., search-web)

string

Full URI path to the skill (e.g., viking://agent/skills/search-web/)

string

Resource type (always directory for skills)

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"

# List all skills with metadata
skills = client.ls("viking://agent/skills/")
for skill in skills:
    print(f"{skill['name']}: {skill['uri']}")

# Simple list (names only)
names = client.ls("viking://agent/skills/", simple=True)
print(names)  # ['search-web', 'calculator', 'code-runner']

openviking ls viking://agent/skills/

{
  "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
}

{
  "status": "ok",
  "result": [
    "search-web",
    "calculator",
    "code-runner"
  ],
  "time": 0.02
}

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)

Add Skill - Add a new skill
Search Skills - Semantic search for skills
Remove Skill - Delete a skill

⌘I

List Skills

curl --request GET \
  --url 'https://api.example.com/api/v1/fs/ls?uri=viking%3A%2F%2Fagent%2Fskills%2F'

const options = {method: 'GET'};

fetch('https://api.example.com/api/v1/fs/ls?uri=viking%3A%2F%2Fagent%2Fskills%2F', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/fs/ls?uri=viking%3A%2F%2Fagent%2Fskills%2F",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/fs/ls?uri=viking%3A%2F%2Fagent%2Fskills%2F"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/fs/ls?uri=viking%3A%2F%2Fagent%2Fskills%2F")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "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
}

{
  "status": "ok",
  "result": [
    "search-web",
    "calculator",
    "code-runner"
  ],
  "time": 0.02
}

Overview

Resources

Filesystem

Search & Retrieval

Sessions

Skills

System

Admin

Authentication

Query Parameters

Response

Example

Skill Storage Structure

Reading Skill Content

​Authentication

​Query Parameters

​Response

​Example

​Skill Storage Structure

​Reading Skill Content

​Related Endpoints

Authentication

Query Parameters

Response

Example

Skill Storage Structure

Reading Skill Content

Related Endpoints