---
title: "List Skills"
method: GET
path: "/api/skills"
tags: ["skills"]
---

# List Skills

`GET /api/skills`

List skill metadata available to the caller, optionally ranked by a search query.

Parameters:
    q (str | None): Optional query used to rank skills by matching terms in their names or descriptions.

Returns:
    list[SkillCardResponse]: Response-formatted skill cards.

## Query parameters

- `q` string, nullable — Optional ranking query

## Response `200`

Successful Response

- SkillCardResponse[]
  - `id` string, uuid, required
  - `name` string, required
  - `description` string, required
  - `scope` 'system' | 'workspace', required
  - `version` string, required
  - `trust` 'system' | 'workspace' | 'untrusted', required
  - `affordances` string[], required
  - `resources_available` boolean, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-07-17** `655778279cb1` — 1 info
  - endpoint added
- **2026-07-17** `62e8c152aa18` — 1 breaking
  - api path removed without deprecation
- **2026-07-15** `216311cd30ec` — 3 warning
  - deleted the `header` request parameter `Authorization`
  - deleted the `header` request parameter `X-Fleet-User-Id`
  - deleted the `header` request parameter `X-Fleet-Workspace-Id`
- **2026-07-13** `f18c4c8586ca` — 6 warning, 3 info
  - removed the optional property `detail` from the response with the `422` status
  - added the new `system` enum value to the `items/scope` response property for the response status `200`
  - added the new `system` enum value to the `items/trust` response property for the response status `200`
  - added the new `untrusted` enum value to the `items/trust` response property for the response status `200`
  - …5 more
- **2026-07-13** `1afc045b25c0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/qredence/apis/fleet-rlm/changes/api/skills/get.md)

---

[API](https://skmtc.dev/qredence/apis/fleet-rlm.md) · [All operations](https://skmtc.dev/qredence/apis/fleet-rlm/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/qredence/fleet-rlm/revisions/3e0490b230d7/schema)