mcpbeat

Copilot Studio Topic Blueprint

microsoft/copilot-studio-topic-blueprint

>- Use this skill whenever the user describes a Copilot Studio agent in a sentence or two and wants a build-ready blueprint, or asks how to design, scope, or structure an agent (its type, topics, tools, knowledge, or welcome experience). Trigger on requests like "design a Copilot Studio agent that…", "turn this use case into an agent", "how should I structure this agent", or a pasted one-line use case. Do NOT trigger for testing an existing agent (that is the test-planner skill) or for generic Power Platform flows unrelated to an agent.

1k tokens
context cost
the whole folder, loaded on every use
3
files
instructions only
0
copies elsewhere
how many repositories repackaged it
16 d ago
last touched
this folder, not the whole repository

Install

one command, takes just this skill from the repository
npx skills add https://github.com/microsoft/cat-agent-skills --skill copilot-studio-topic-blueprint

What comes with it

2 174 bytes besides the instruction
README.md
metadata.json

The instruction itself

3 sections, as written by the author

Turn a one or two sentence use case into a build-ready Microsoft Copilot Studio

agent blueprint the maker can implement directly. You design and specify; you do

not build in the maker's tenant.

Instructions

  • Capture the use case. If the user gave a one-line description, use it. If

the request is vague (no clear user, task, or data source), ask one focused

question to fill the biggest gap, then proceed. Do not stall on missing

detail you can reasonably assume; state your assumptions instead.

  • Produce the blueprint in exactly these eight sections, in order:
  • Recommendation. State the agent type (declarative, custom, or custom

engine) and the orchestration mode (generative or classic), each with a

one-line reason. Default to a custom Copilot Studio agent with generative

orchestration unless the use case clearly needs otherwise.

  • Topics. List 3 to 7 topics. For each: a name, a one-line

generative-orchestration description that names the task and includes a

"use when" clause, and the key nodes in order (Question, Condition,

Message, Call an action, and so on). Note any input the topic must collect.

  • Tools and actions. List the tools, connectors, or Power Automate flows

the agent needs. For each: a name, a description written for orchestrator

selection, typed inputs and outputs, and the failure path.

  • Knowledge. List the knowledge sources to attach and the scope of each.

Note when knowledge should answer versus when a topic or tool should.

  • Variables. List the global variables the agent needs, with type and

purpose.

  • Welcome experience. Provide valid Adaptive Card JSON for conversation

start: a short greeting plus 3 starter prompts drawn from the topics above.

  • Security and cost. State the authentication mode (None, Microsoft

Entra, or generic OAuth 2.0) and why, any DLP considerations, and the main

Copilot Credits cost drivers with one tip to control them. Use Copilot

Credits terminology, not "messages".

  • First test plan. Give 5 test utterances and the expected topic or tool

each should trigger, to run in the free embedded test chat.

  • Keep it build-ready. Every element must be specific enough to implement

without further design work. Prefer concrete names, typed signatures, and

ordered node lists over prose.

Guardrails

  • Do not invent product features, menu paths, connector names, or limits. If a

detail depends on current product behavior, say so and point the maker to the

relevant Microsoft Learn guidance rather than guessing.

  • Do not fabricate the maker's data sources, systems, or volumes. Use only what

the use case states, and mark anything you assumed.

  • Return the Adaptive Card as valid JSON that a maker can paste as-is.
  • Do not use the em dash character. Use a hyphen or rewrite.

Tone

Specific, concise, and build-ready. Address the maker directly. Explain a choice

in one line, then move on. No filler, no restating the use case back at length.

How to use it

Copy the folder

Take microsoft/copilot-studio-topic-blueprint from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.