Add an existing skill to an agent

In addition to creating skills from scratch, you can add existing skills to your agent by browsing a skill catalog or uploading a skill package.

Note

Features in this article are powered by the GitHub Copilot harness, which uses Copilot Credits for usage-based billing. Learn more about Copilot Credits in Overview of billing for agents powered by the GitHub Copilot harness.

Usage-based billing applies to using, building, testing, and evaluating agents. These actions might consume Copilot Credits.

Prerequisites

  • An agent created with the GitHub Copilot harness. See Create an agent (preview).
  • A Markdown file containing the skill name and description in YAML front matter, plus instructions.

Upload a skill file

You can add a skill to your agent by uploading a skill file.

  1. Open your agent in Copilot Studio.

  2. Select the Build tab.

  3. In the components panel, select Skills.

  4. In Add skill, select Upload a skill.

  5. Drag and drop the file onto the upload box. Alternatively, select the box and browse to the file you want to upload.

  6. The system validates the file and adds the skill to your agent.

Tip

Start with a simple skill and refine it based on testing. You can edit the instructions for a skill you upload in your preferred text editor and then replace the uploaded skill.

Accepted formats for skill files and packages

  • A Markdown file containing the skill name and description in YAML front matter, plus instructions.
  • A ZIP file that must include a SKILL.md file, with the skill name and description formatted in YAML front matter and instructions in Markdown. The package can optionally include supporting files, such as scripts, templates, and reference documents.