Agent Skills

A Skill packages task-specific instructions and resources that can be used by a Visual Agent.

Each Skill contains the following fields:

• Name (Skill ID): Used by the agent to identify the skill. (Must use lowercase alphanumeric characters and single hyphens only. Must start and end with an alphanumeric character. Max 64 characters.)

• Description: Describes the skill’s purpose and usage. The agent uses this to determine whether the Skill should be loaded. (Max 1024 characters.)

• Metadata (optional): Key/value pairs used by the agent as additional information

• Instructions: Loaded only when the Agent decides the Skill is relevant. Provides detailed guidance for the agent to follow, such as workflows, rules, assumptions, and response format. Supports Markdown.

• Resources (optional): Additional text and image files that can be referenced in the instructions. Only loaded when relevant.

See the Agent Skills format for more information about writing SKILL.md files.