One-click install
npx skills add https://github.com/microsoft/Employee-Self-Service-Agent-Developer-Kit --skill update-topic-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Update Topic Skill
Source: https://github.com/microsoft/Employee-Self-Service-Agent-Developer-Kit/tree/main/solutions/ess-maker-skills/src/skills/topics/update
Command: npx skills add https://github.com/microsoft/Employee-Self-Service-Agent-Developer-Kit --skill update-topic-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Manually editing local Copilot Studio topic files does not update the live environment, and unvetted edits can break existing topic flows, references, or system-critical functionality. Users often forget to push changes after editing, or accidentally modify system topics without understanding the potential side effects.

Core Features & Use Cases

  • Guided Update Workflow: Step-by-step instructions for identifying the target topic, proposing edits, and validating changes before deployment.
  • Safety Guardrails: Automatic checkpointing before edits, warnings against modifying system topics, and error scanning to catch broken references or flow chains.
  • Use Case: A customer support team needs to update the trigger phrases for their "return request" topic to match new common user queries; this skill guides them through editing the local file, validating the changes, and pushing the update to the live Copilot Studio environment.

Quick Start

Use this skill to update the trigger phrases for your "order status" Copilot Studio topic and push the change to your live environment.

Frequently Asked Questions about Update Topic Skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update Copilot Studio topics and push changes to the live environment?

To update Copilot Studio topics, you modify local agent working copy files, validate the changes via the Copilot Studio API, and run checkpoint and push scripts to deploy updates to the live environment.

Why are my local Copilot Studio topic edits not showing up in the live environment?

Local Copilot Studio topic edits remain unreleased because you must explicitly run checkpoint and push scripts to validate and deploy the modifications through the Copilot Studio API.

What is the safest way to modify trigger phrases and response messages in Copilot Studio?

The safest way to modify trigger phrases and response messages is using a guided workflow that creates automatic checkpoints before edits and scans for broken references or flow chains before deployment.

Can I edit system-critical Copilot Studio topics using this workflow?

You can edit system-critical Copilot Studio topics, but the update workflow provides explicit warnings regarding potential side effects to prevent unvetted modifications from breaking existing functionality.

Do I need Copilot Studio API access to validate and deploy topic modifications?

Yes, Copilot Studio API access is required along with local agent working copy files and checkpoint scripts to validate changes and successfully deploy topic updates to live environments.

What happens if I accidentally break action chains or workflow references in my topic files?

If you break action chains or workflow references, the update workflow's error scanning catches these issues during validation before any changes are pushed to the live Copilot Studio environment.