HTTP API
AgentSkillDefinition
A markdown-based skill definition that can be loaded into an agent at run time.
Shape: object
| Property | Required | Type | Description | Rules |
|---|---|---|---|---|
id |
no | string (uuid) |
The skill’s unique identifier. | — |
tenantId |
yes | string |
The tenant the skill belongs to. | — |
name |
yes | string |
The skill name. Agent definitions bind to the skill with this name. | — |
description |
yes | string |
The skill’s short description. | — |
instructions |
yes | string |
The markdown instructions given to the model. | — |
compatibility |
no | string |
The skill’s compatibility statement. | — |
license |
no | string |
The skill license. | — |
allowedTools |
no | string |
The allowed-tools declaration in the MAF frontmatter. | — |
metadata |
no | object |
Application-specific free-form metadata. | — |
enabled |
no | boolean |
Whether the skill is included in compilation. | — |
version |
no | integer (int32) |
The skill record’s version. | pattern `^-?(?:0\ |
resources |
no | array of AgentSkillResourceDefinition |
The skill’s resources. | — |
scripts |
no | array of AgentSkillScriptDefinition |
The skill’s scripts, stored in the database or registered in code. | — |
scriptSetHash |
no | string |
The fingerprint of the whole script set: every script’s name and content hash. Computed, never stored; a value sent in a request is ignored. | — |
origin |
no | AgentDefinitionOrigin |
Where the definition comes from: AgentDefinitionOrigin.Code for a skill registered with AddSkill, AgentDefinitionOrigin.Database for a stored one. |
— |
createdAt |
no | string (date-time) |
The skill’s creation time. | — |
updatedAt |
no | string (date-time) |
The skill’s last-updated time. | — |