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

---

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