Skills: List

Last updated August 28, 2026Open markdown version

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.

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

{
  "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
  }
}