# AgentSkillRequest

> 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/agentskillrequest/
> Summary: OpenAPI request or response schema for AgentSkillRequest, including required fields, defaults, constraints, and linked nested types.

[← All HTTP schemas](/http-api/schemas/)

Request to create or update a skill.

**Shape:** `object`

| Property | Required | Type | Description | Rules |
|---|---|---|---|---|
| `name` | yes | `string` | Skill name. | — |
| `description` | yes | `string` | Skill description. | — |
| `instructions` | yes | `string` | Markdown instructions. | — |
| `compatibility` | no | `string` | Compatibility statement. | — |
| `license` | no | `string` | Skill license. | — |
| `allowedTools` | no | `string` | Allowed-tools declaration from the MAF frontmatter. | — |
| `metadata` | no | `object` | Application-specific metadata. | — |
| `enabled` | no | `boolean` | Whether the skill is enabled. | — |
| `resources` | no | array of [`AgentSkillResourceDefinition`](/http-api/schemas/agentskillresourcedefinition/) | Skill resources. | — |
| `scripts` | no | array of [`AgentSkillScriptDefinition`](/http-api/schemas/agentskillscriptdefinition/) | Skill scripts. | — |