概述

列出已安装的 Skill。未指定 target_uri 时，接口分别读取当前用户（鉴权 API Key 所属的目录用户）私有 Skill 根和账户共享 Skill 根，再按“用户私有在前、账户共享在后”的顺序直接拼接；同名 Skill 不去重，可通过返回的 root_uri 区分来源。

请求接口

URI	`/api/v1/skills`
请求方法	GET
认证	`Authorization: Bearer {API_KEY}`

请求参数

参数	位置	类型	必选	默认值	说明
`node_limit`	Query	integer	否	1000	声明的节点上限。当前实现虽接收该参数，但底层仍固定按每个作用域最多 1000 个节点读取；现阶段不要依赖它做小页分页或精确裁剪。
`target_uri`	Query	string	否	null	限定一个 Skill 根。推荐使用当前用户 canonical 根或 `viking://agent/skills`。不传时合并两个默认作用域。

响应消息

字段	类型	说明
`result.root_uris`	array	未传 target_uri 时返回，本次读取的两个默认 Skill 根。
`result.root_uri`	string	传入 target_uri 时返回，本次读取的单一 Skill 根。
`result.skills`	array	Skill 摘要列表。
`result.total`	integer	本次返回的 Skill 数量。
`result.skills[].type`	string	固定为 `skill`。
`result.skills[].name`	string	Skill 名称。
`result.skills[].uri`	string	Skill 目录 URI。
`result.skills[].root_uri`	string	与 uri 相同。
`result.skills[].skill_md_uri`	string	SKILL.md 的 URI。
`result.skills[].description`	string	Skill 描述。
`result.skills[].tags`	array	标签列表。
`result.skills[].allowed_tools`	array	允许使用的工具列表。

完整示例

curl -X GET "{BASE_URL}/api/v1/skills" \
  -H "Authorization: Bearer {API_KEY}"

{
  "status": "ok",
  "result": {
    "root_uris": [
      "viking://user/alice/skills",
      "viking://agent/skills"
    ],
    "skills": [
      {
        "type": "skill",
        "name": "search-web",
        "uri": "viking://user/alice/skills/search-web",
        "root_uri": "viking://user/alice/skills/search-web",
        "skill_md_uri": "viking://user/alice/skills/search-web/SKILL.md",
        "description": "搜索互联网中的最新信息",
        "tags": ["search"],
        "allowed_tools": ["web"]
      }
    ],
    "total": 1
  }
}

常见错误与边界

场景	行为
目标根不存在	当前列表实现返回空 skills 和 total=0，而不是 404。
两个作用域存在同名 Skill	两个条目都会返回，不会去重。
需要分页	本接口当前没有 offset/cursor；node_limit 也不能作为可靠的小页裁剪参数。

最近更新时间：2026.07.22 18:07:44

这个页面对您有帮助吗？

有用

无用

向量数据库VikingDB

概述 #

请求接口 #

请求参数 #

响应消息 #

完整示例 #

常见错误与边界 #

概述

请求接口

请求参数

响应消息

完整示例

常见错误与边界