Skills: Get
Description
Retrieve a single skill. Skills are addressed by name, and skill names are only unique within a team, so team_id is required.
Request
HTTP Method: GET
| Path Parameter | Description |
|---|---|
| skill_name | The name of the skill to retrieve. |
| Query Parameter | Description |
|---|---|
| team_id | ID of the team that owns the skill. |
curl --proto '=https' --tlsv1.2 -X GET \
'https://<tenant-domain>/api/v1/skills/<<skill_name>>?team_id=42' \
-H 'content-type: application/json' \
-H 'Authorization: Bearer <<CREDENTIAL.tines_api_key>>'
Response
A successful request will return a JSON object describing the requested 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"
}