> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitheo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 列出技能

> 列出市场中的技能或已安装的技能。

列出可用技能。可按已安装技能筛选，也可浏览完整的技能市场。

## 身份验证

需要 Bearer 令牌。参见[身份验证](/api-reference/authentication)。

## 查询参数

<ParamField query="filter" type="string">
  筛选技能。可选值：

  * `"installed"` — 仅返回已通过身份验证的用户安装的技能
  * `"marketplace"` — 所有公开的市场技能（省略该参数时的默认值）
</ParamField>

## 请求示例

<CodeGroup>
  ```bash curl theme={null}
  # 列出已安装的技能
  curl "https://www.hitheo.ai/api/v1/skills?filter=installed" \
    -H "Authorization: Bearer $THEO_API_KEY"

  # 浏览技能市场
  curl https://www.hitheo.ai/api/v1/skills \
    -H "Authorization: Bearer $THEO_API_KEY"
  ```

  ```typescript SDK theme={null}
  // 已安装的技能
  const installed = await theo.skills("installed");

  // 技能市场
  const marketplace = await theo.skills("marketplace");
  ```
</CodeGroup>

## 响应

<ResponseField name="skills" type="object[]">
  技能对象数组。每个对象包含 `id`、`name`、`slug`、`description`、`category`、`version`、`installCount`、`isPublic` 等字段。
</ResponseField>

### 响应示例

```json theme={null}
{
  "skills": [
    {
      "id": "skill_abc123",
      "name": "Deep Research",
      "slug": "deep-research",
      "description": "Multi-step web research with citations and structured reports",
      "category": "productivity",
      "version": "1.2.0",
      "installCount": 342,
      "isPublic": true,
      "authorUserId": "user_xyz"
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.