Deploy organization skills for Copilot in PowerPoint

Applies To
PowerPoint for Microsoft 365 PowerPoint for Microsoft 365 for Mac PowerPoint for iPad

Note

If you don’t see Copilot in Word, Excel, PowerPoint, or OneNote, it might not be included with your Microsoft 365 subscription or available based on your organization’s settings. Learn which Copilot license you have.

Microsoft 365 administrators can upload and deploy custom skills for use with Copilot in PowerPoint. You can make a skill available to everyone in your organization or to specific users and groups.

Upload and deploy a custom skill for your organization

  1. Sign in to the Microsoft 365 admin center.

  2. In the left navigation pane, select Agents > All agents. Select the More actions (...) menu, and then select Add agent.

    Screenshot that shows selecting Add agent from the All agents page in the Microsoft 365 admin center.

  3. On the Upload agent to publish page, select Choose file, and then upload the skill package (.zip).

    Screenshot that shows uploading a skill package on the Upload agent to publish page.

  4. Review the validation results. If validation fails, correct the package structure or manifest, and then upload the package again. For requirements, see Package a custom skill for deployment later in this article.

    Screenshot that shows the package validation results in the Microsoft 365 admin center.

    Screenshot that shows the details of a successful package validation.

  5. Choose who can use the skill. Select all users or specific users and groups, configure the available deployment options, and then complete the publishing flow.

    Screenshot that shows choosing which users and groups can use the skill.

  6. To verify the deployment, go to Agents > Tools in the Microsoft 365 admin center. Select the skill to review its details, users, version, and deployment status.

    Screenshot that shows the deployed skill on the Tools page in the Microsoft 365 admin center.

    Screenshot that shows the details, users, version, and deployment status of a skill.

  7. After the skill is published and installed, open PowerPoint with an account included in the deployment. Open the Copilot chat pane, select the + menu in the prompt box, and then select Choose skills.

    Screenshot that shows selecting Choose skills from the plus menu in the Copilot pane.

  8. Find the custom skill shared by your organization in the skills list. The skill is visible only to users included in the deployment.

    Screenshot that shows a custom organization skill in the Choose skills list.

Package a custom skill for deployment

A custom skill ready to be deployed must be packaged as a .zip file that includes the skill files, an app manifest, and icons. The Microsoft 365 admin center validates the package when you upload it.

Before you upload the package, verify that it uses the following structure.

Screenshot that shows the ZIP structure of a skill package. The infographic-summary.zip file contains manifest.json, color.png, outline.png, and an infographic-summary folder, and the infographic-summary folder contains SKILL.md.

The manifest.json file describes the package to the Microsoft 365 admin center. For the latest manifest schema guidance, see Microsoft 365 app manifest schema reference.

Use a unique GUID for the id property, provide concise names and descriptions, and make sure the paths match the files in the package. The following example shows a basic manifest.

{
  "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.28/MicrosoftTeams.schema.json",
  "manifestVersion": "1.28",
  "version": "1.0.0",
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "developer": {
    "name": "Rolly Seth",
    "websiteUrl": "https://localhost",
    "privacyUrl": "https://localhost/privacy",
    "termsOfUseUrl": "https://localhost/terms"
  },
  "name": {
    "short": "Infographic Summary",
    "full": "Presentation Infographic Summary"
  },
  "description": {
    "short": "Creates an infographic overview of a presentation.",
    "full": "Reads a presentation and generates an editorial-style infographic summary."
  },
  "icons": {
    "color": "color.png",
    "outline": "outline.png"
  },
  "accentColor": "#2E86DE",
  "agentSkills": [
    {
      "path": "./skills/infographic-summary"
    }
  ]
}

Include both icon files referenced by manifest.json: color.png, a full-color 192x192 PNG icon, and outline.png, a monochrome outline 32x32 PNG icon. The icons identify the skill in the Microsoft 365 admin center.

You can also use the Agent 365 CLI to prepare and publish a package, or to retrieve values required by the manifest, such as the agent blueprint ID. For more information, see Publish Agent to Microsoft Admin Center and Agent 365 CLI setup command reference.

Screenshot that shows the contents of a skill package folder: a skills folder, and the color.png, manifest.json, and outline.png files.