Skip to content
AI & Agents
Skill

/list-topics

List all topics in the Copilot Studio agent with their trigger types, phrases, and action counts. Use when the user wants to see what topics exist.

BOOST
From plugin
copilot-studio
46931 skills4 agents1 hook
Install
$ npx -y skills add microsoft/skills-for-copilot-studio --skill list-topics --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/list-topics

Context preview

The summary Claude sees to decide when to auto-load this skill.

List all topics in the Copilot Studio agent with their trigger types, phrases, and action counts. Use when the user wants to see what topics exist.

SKILL.md

list-topics.SKILL.md
user-invocable: false
description: List all topics in the Copilot Studio agent with their trigger types, phrases, and action counts. Use when the user wants to see what topics exist.
allowed-tools: Read, Glob, Grep

List Topics in Solution

List all topics in the current agent with their trigger types and details.

Instructions

1. **Auto-discover the agent directory** — find all agents via:

   Glob: **/agent.mcs.yml
  • If multiple agents found, list them and ask which one to inspect.
  • NEVER hardcode an agent name or path.

2. Find all topic files in the discovered agent directory:

   Glob: <discovered-agent>/topics/*.topic.mcs.yml

3. For each topic file, read it and extract:

  • Topic name (from the `# Name:` comment or filename)
  • Trigger type (from `beginDialog.kind`)
  • Trigger phrases (if `OnRecognizedIntent`, from `triggerQueries`)
  • Number of actions in the `actions` array
  • Dialog references (any `BeginDialog` or `ReplaceDialog` calls)

4. Present results in a table:

   | # | Topic Name | Trigger | Phrases | Actions | Calls |
   |---|------------|---------|---------|---------|-------|
   | 1 | Greeting   | OnRecognizedIntent | Hello, Hi, Hey | 2 | - |
   | 2 | Fallback   | OnUnknownIntent | - | 4 | Escalate |

5. Note any system topics (OnError, OnSelectIntent, OnSignIn) that should be modified with care.

Read more
Ships withcopilot-studio

A plugin for Claude Code, GitHub Copilot CLI, and VS Code that enables authoring, testing, and troubleshooting Microsoft Copilot Studio STANDARD agents through YAML files — directly from your terminal or editor.

Get the whole plugin

Other skills on copilot-studio.