new-topic

Create New Topic

Generate a new Copilot Studio topic YAML file based on user requirements.

Instructions

1. Auto-discover the agent directory:

   Glob: **/agent.mcs.yml
   

   If multiple agents found, ask which one. NEVER hardcode an agent name.

2. Check for matching templates in ${CLAUDE_SKILL_DIR}/../../templates/topics/ first:

   • greeting.topic.mcs.yml — OnConversationStart greeting
   • fallback.topic.mcs.yml — OnUnknownIntent fallback with escalation
   • arithmeticsum.topic.mcs.yml — Topic with inputs/outputs and computation
   • question-topic.topic.mcs.yml — Question with branching logic
   • search-topic.topic.mcs.yml — Generative answers from knowledge
   • auth-topic.topic.mcs.yml — Authentication flow
   • error-handler.topic.mcs.yml — Error handling
   • disambiguation.topic.mcs.yml — Multiple topics matched If a template matches, use it as the starting point.

3. MANDATORY: Verify ALL kind: values against the schema before writing them:

   node ${CLAUDE_SKILL_DIR}/../../scripts/schema-lookup.bundle.js kinds                    # List all valid kind values
   node ${CLAUDE_SKILL_DIR}/../../scripts/schema-lookup.bundle.js resolve AdaptiveDialog   # Resolve trigger structure
   node ${CLAUDE_SKILL_DIR}/../../scripts/schema-lookup.bundle.js resolve <TriggerType>    # Resolve specific trigger
   node ${CLAUDE_SKILL_DIR}/../../scripts/schema-lookup.bundle.js search <ActionKind>      # Verify an action kind exists
   

   NEVER write a kind: value you haven't verified exists in the schema. This is the #1 source of hallucination errors. If schema-lookup.bundle.js search <kind> returns no results, the kind does NOT exist — do not use it.

4. Determine the trigger type from the user's description:

   • OnRecognizedIntent — For topics triggered by user phrases (most common)
   • OnConversationStart — For welcome/greeting topics
   • OnUnknownIntent — For fallback topics
   • OnEscalate — For escalation to human agent
   • OnError — For error handling