Delete Topic Skill

Delete Copilot Studio agent topics and sync changes to the live Dataverse environment.

25|8|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/microsoft/Employee-Self-Service-Agent-Developer-Kit --skill delete-topic-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Delete Topic Skill
Source: https://github.com/microsoft/Employee-Self-Service-Agent-Developer-Kit/tree/main/solutions/ess-maker-skills/src/skills/topics/delete
Command: npx skills add https://github.com/microsoft/Employee-Self-Service-Agent-Developer-Kit --skill delete-topic-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Deleting a topic from a Copilot Studio agent requires more than just removing the local file, as local files are only a working copy of the live environment. Without syncing deletions to the live agent, outdated topics remain active, and accidental deletion of system topics can break core agent functionality.

Core Features & Use Cases

  • End-to-end deletion workflow: Guides users through identifying, confirming, and deleting topics, then syncing the change to the live Copilot Studio environment via push.
  • Built-in safety guardrails: Includes pre-deletion checkpoints, user confirmation prompts, system topic risk warnings, and dry-run previews to prevent accidental data loss or agent breakage.
  • Use case: A maker needs to remove an outdated "Old Benefits FAQ" topic from their employee self-service agent to clean up the agent's navigation; this skill ensures the deletion is applied both locally and in the live environment, with a revert option if the deletion causes unexpected issues.

Quick Start

Use the delete topic skill to remove the "Legacy Password Reset" topic from your Copilot Studio agent and sync the change to the live environment.

Frequently Asked Questions about Delete Topic Skill

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

FAQPage Schema
How do I delete a topic from a Copilot Studio agent and sync it to Dataverse?

Deleting a Copilot Studio topic requires syncing the change to the live Dataverse environment, not just removing the local file. A safe deletion workflow includes pre-deletion checkpoints, dry-run previews, and automated push operations to ensure the change is applied successfully.

What happens if I accidentally delete a system topic in Copilot Studio?

Accidentally deleting a system topic can break core agent functionality. Safe deletion workflows mitigate this risk by providing system topic warnings, user confirmation prompts, and pre-deletion checkpoints to prevent accidental data loss before pushing changes.

Can I preview topic deletion before pushing changes to the live agent?

Yes, you can preview topic deletion using a dry-run before pushing changes to the live Copilot Studio agent. This helps identify potential issues and ensures no critical system topics are accidentally affected before the synchronization occurs.

Why do deleted topics remain active in my Copilot Studio agent?

Deleted topics remain active in Copilot Studio because local files are only a working copy of the live Dataverse environment. Without pushing the deletion to synchronize the change, outdated topics will continue to function in the live agent.

Is there a way to revert topic deletion in Copilot Studio if something breaks?

Yes, safe topic deletion workflows provide a revert option if deletion causes unexpected issues. By implementing pre-deletion checkpoints before pushing changes to the live Dataverse environment, you can restore the agent's previous state if functionality breaks.

What's the best way to clean up outdated topics in a Copilot Studio agent?

The best way to clean up outdated Copilot Studio topics is using an end-to-end deletion workflow that identifies, confirms, and deletes topics, then syncs changes to the live environment via an automated push. This ensures safe, reversible removal of unused agent content.