List Skills

GET /api/v1/fs/ls?uri=viking:/agent/skills

List Skills

cURL

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

Response

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

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

Show Skill Object

name · string

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

uri · string

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

type · string

Resource type (always directory for skills)

time · number

Request processing time in seconds

Example

cURL

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

Response

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

Related Endpoints

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