Skip to content

AgentSkillDefinition

← All HTTP schemas

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.
createdAt no string (date-time) The skill’s creation time.
updatedAt no string (date-time) The skill’s last-updated time.