Manage and delete skills in an agent (preview)

[This article is prerelease documentation and is subject to change.]

After adding skills to your agent, you can edit, download, replace, and delete them from the Build tab. Keeping your agent's skills organized and up to date ensures the best user experience.

Note

This article reflects the new agent experience in Microsoft Copilot Studio, which is currently available as a production-ready preview. Learn about the two experiences in Classic vs. new agent experience.

  • Production-ready previews are subject to supplemental terms of use.
  • Some capabilities available in the classic experience aren't yet available in the new experience.
  • Agents created in the new experience can't be converted to the classic experience.

View your agent's skills

  1. Open your agent in Copilot Studio.

  2. Select the Build tab.

  3. In the components panel, the Skills section shows the skills you added to your agent.

Edit a skill you created from blank

You can edit skills you create from blank directly in the skill configuration panel.

  1. Select the skill you want to edit to open the skill configuration panel.

  2. Update any of the following elements:

    • Name: The skill's identifier. Use only lowercase letters, numbers, and hyphens. Don't start or end the name with a hyphen.
    • Description: What the skill does and when it should be activated.
    • Instructions: The Markdown instructions that guide the agent's behavior.

  3. Select Save to apply your changes.

Tip

After editing a skill, test your agent in the Preview tab to verify the changes work as expected.

Download a skill

You can download a skill to share it with others or back it up.

  1. Select the skill you want to download to open its configuration panel.

  2. Depending on the skill:

    • If you created the skill from blank, select the Download icon.
    • If you uploaded the skill, select the three dots (…) and then select Download.

The skill is downloaded as a Markdown file containing the skill name and description in YAML front matter, plus instructions. The filename matches the skill's name.

Replace a skill you uploaded

After editing the instructions for an existing skill in your preferred text editor, upload your changes by replacing the current version of the skill in your agent. You can also replace a skill with another skill.

  1. Select the skill you want to replace to open the skill configuration panel.

  2. Select the three dots (…) and then select Replace.

  3. Browse to the skill file you want and select it.

Delete a skill

  1. In the components panel, select the X icon next to the skill you want to delete. A message prompts you to confirm your intention.

  2. Select Delete to confirm the deletion.

Note

Deleting a skill removes it permanently from this agent. If you might need the skill later, download it first.

  • Last updated on