> ## 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.

# List Skills

> List marketplace or installed skills.

List available skills. Filter by installed skills or browse the full marketplace.

## Authentication

Requires a Bearer token. See [Authentication](/api-reference/authentication).

## Query Parameters

<ParamField query="filter" type="string">
  Filter skills. Options:

  * `"installed"` — Only skills installed by the authenticated user
  * `"marketplace"` — All public marketplace skills (default when omitted)
</ParamField>

## Request Examples

<CodeGroup>
  ```bash curl theme={null}
  # List installed skills
  curl "https://www.hitheo.ai/api/v1/skills?filter=installed" \
    -H "Authorization: Bearer $THEO_API_KEY"

  # Browse marketplace
  curl https://www.hitheo.ai/api/v1/skills \
    -H "Authorization: Bearer $THEO_API_KEY"
  ```

  ```typescript SDK theme={null}
  // Installed skills
  const installed = await theo.skills("installed");

  // Marketplace
  const marketplace = await theo.skills("marketplace");
  ```
</CodeGroup>

## Response

<ResponseField name="skills" type="object[]">
  Array of skill objects. Each includes `id`, `name`, `slug`, `description`, `category`, `version`, `installCount`, `isPublic`, and more.
</ResponseField>

### Example Response

```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"
    }
  ]
}
```