Skills: Create

Last updated August 28, 2026Open markdown version

Description

Create a skill in Tines.

Request

HTTP Method: POST

Body Parameter	Description
team_id	ID of the team to create the skill for.
name	Skill name. Lowercase alphanumeric with hyphens (for example, `triage-alerts`), unique within the team.
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	Optional License the skill is distributed under.
compatibility	Optional Free-text note on what the skill is compatible with.
metadata	Optional Flat map of string keys to string values.

Sample request

curl --proto '=https' --tlsv1.2 -X POST \
  https://<tenant-domain>/api/v1/skills \
  -H 'content-type: application/json' \
  -H 'Authorization: Bearer <<CREDENTIAL.tines_api_key>>' \
  -d '{
        "team_id": 42,
        "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",
        "metadata": { "source_repo": "runbooks" }
      }'

Response

A successful request will return a JSON object describing the created skill.

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

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