AgentSkillFrontmatter Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Represents the YAML frontmatter metadata parsed from a SKILL.md file.
public sealed class AgentSkillFrontmattertype AgentSkillFrontmatter = classPublic NotInheritable Class AgentSkillFrontmatter- Inheritance
-
AgentSkillFrontmatter
Remarks
Frontmatter is the L1 (discovery) layer of the Agent Skills specification. It contains the minimal metadata needed to advertise a skill in the system prompt without loading the full skill content.
The constructor validates the name and description against specification rules and throws ArgumentException if either value is invalid.
Constructors
| Name | Description |
|---|---|
| AgentSkillFrontmatter(String, String, String) |
Initializes a new instance of the AgentSkillFrontmatter class. |
Properties
| Name | Description |
|---|---|
| AllowedTools |
Gets or sets optional space-delimited list of pre-approved tools. |
| Compatibility |
Gets or sets optional compatibility information (max 500 chars). |
| Description |
Gets the skill description. Used for discovery in the system prompt. |
| License |
Gets or sets an optional license name or reference. |
| Metadata |
Gets or sets the arbitrary key-value metadata for this skill. |
| Name |
Gets the skill name. Lowercase letters, numbers, and hyphens only; no leading, trailing, or consecutive hyphens. |
Methods
| Name | Description |
|---|---|
| ValidateCompatibility(String, String) |
Validates an optional skill compatibility value against specification rules. |
| ValidateDescription(String, String) |
Validates a skill description against specification rules. |
| ValidateName(String, String) |
Validates a skill name against specification rules. |