---
title: List
url: https://www.tines.com/stories/docs/api/skills/list/
updated: 2026-08-28T15:50:18+00:00
description: Retrieve a list of skills.
---

*[tines.com](https://www.tines.com/llms.txt) › [Docs](https://www.tines.com/stories/docs/llms.txt) › [Tines API](https://www.tines.com/stories/docs/api/llms.txt) › [Skills](https://www.tines.com/llm/stories/docs/api/skills.md)*

# List

*[View on tines.com](https://www.tines.com/stories/docs/api/skills/list/)*

## Description

Retrieve a list of skills.

## Request

HTTP Method: **GET**

| Query Parameter | Description                                                           |
| --------------- | --------------------------------------------------------------------- |
| team_id         | **Optional** Only return skills owned by this team.                   |
| search          | **Optional** Only return skills whose name contains this text.        |
| per_page        | **Optional** The number of results returned per page. Defaults to 20. |
| page            | **Optional** The page of results to return. Defaults to 1.            |

```bash
curl --proto '=https' --tlsv1.2 -X GET \
  https://<tenant-domain>/api/v1/skills \
  -H 'content-type: application/json' \
  -H 'Authorization: Bearer <<CREDENTIAL.tines_api_key>>'
```

## Response

A successful request will return a JSON object containing an array of the skills the requesting token has access to.

### Field description

| Parameter     | Description                                                                                                                                                   |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| name          | Skill name.                                                                                                                                                   |
| description   | What the skill does and when to use it. AI agents are shown only the name and description, and match a task against them to decide whether to load the skill. |
| body          | The full skill instructions, in markdown. Loaded only after the description matches the task at hand.                                                         |
| license       | License the skill is distributed under. Null when it was never set.                                                                                           |
| compatibility | Free-text note on what the skill is compatible with. Null when it was never set.                                                                              |
| metadata      | Flat map of string keys to string values, empty when none are set.                                                                                            |
| team_id       | ID of the team that owns the skill.                                                                                                                           |
| created_at    | ISO 8601 timestamp describing when the skill was created.                                                                                                     |
| updated_at    | ISO 8601 timestamp describing when the skill was last updated.                                                                                                |

### Sample response

```json
{
  "skills": [
    {
      "name": "triage-alerts",
      "description": "Triage inbound security alerts. Use when a new alert needs a severity assessment.",
      "body": "# Triage alerts\n\nStart by checking the alert severity.",
      "license": "Apache-2.0",
      "compatibility": null,
      "metadata": { "source_repo": "runbooks" },
      "team_id": 42,
      "created_at": "2026-08-26T09:00:00.000Z",
      "updated_at": "2026-08-26T09:00:00.000Z"
    },
    {
      "name": "summarize-cases",
      "description": "Summarize a case for handover. Use when an analyst is closing out a shift.",
      "body": "# Summarize cases\n\nList the open tasks first.",
      "license": null,
      "compatibility": null,
      "metadata": {},
      "team_id": 42,
      "created_at": "2026-08-26T09:04:11.491Z",
      "updated_at": "2026-08-26T09:04:11.491Z"
    }
  ],
  "meta": {
    "current_page": "https://<tenant-domain>/api/v1/skills?per_page=20&page=1",
    "previous_page": null,
    "next_page": null,
    "next_page_number": null,
    "per_page": 20,
    "pages": 1,
    "count": 2
  }
}
```