# AgentSkillDefinition

> Tracon documentation. Tracon is a .NET package family that adds a control
> plane on Microsoft Agent Framework, published as NuGet packages that run
> inside your own ASP.NET Core application.
>
> Page: https://tracon.dev/http-api/schemas/agentskilldefinition/
> Summary: OpenAPI request or response schema for AgentSkillDefinition, including required fields, defaults, constraints, and linked nested types.

[← All HTTP schemas](/http-api/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\\|[1-9]\d*)$` |
| `resources` | no | array of [`AgentSkillResourceDefinition`](/http-api/schemas/agentskillresourcedefinition/) | The skill's resources. | — |
| `scripts` | no | array of [`AgentSkillScriptDefinition`](/http-api/schemas/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`](/http-api/schemas/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. | — |