
copilot-studio
✓ Official★ 345Claude Code plugin · microsoft/skills-for-copilot-studio · MIT
Microsoft Copilot Studio YAML authoring toolkit. Create, edit, validate, and test Copilot Studio agents using YAML files.
31 skills · 4 sub-agents · hooks — installs as one unit
⌁ skills (31)
add-action
Guide users through adding a new connector action to a Copilot Studio agent. Connector actions require UI-based connection setup, so this skill walks users through the Copilot Studio portal steps, then delegates to edit-action for YAML modifications.
Full instructions & audit →add-adaptive-card
Generate and insert an Adaptive Card into a Copilot Studio topic using AdaptiveCardPrompt. Use when the user asks to add an adaptive card, rich card, form card, info card, confirmation card, or interactive card to a topic.
Full instructions & audit →add-generative-answers
Add generative answer nodes (SearchAndSummarizeContent or AnswerQuestionWithAI) to a Copilot Studio topic. Use this instead of /add-node when the user asks to add grounded answers, knowledge search, generative answers, or AI-powered responses — these nodes require specific patterns (ConditionGroup follow-up, knowledge source references, autoSend, responseCaptureType) that /add-node does not cover.
Full instructions & audit →add-global-variable
Add a global variable to a Copilot Studio agent. Use when the user needs a variable that persists across topics in the same conversation and can optionally be visible to the AI orchestrator.
Full instructions & audit →add-knowledge
Add a knowledge source (public website or SharePoint) to a Copilot Studio agent. Use when the user asks to add a knowledge source, documentation URL, website, or SharePoint site for the agent to search.
Full instructions & audit →add-node
Add or modify a node in an existing Copilot Studio topic. Use when the user asks to add a question, message, condition, variable, or other node to a topic. Do NOT use this for generative answers or knowledge search — use /add-generative-answers instead.
Full instructions & audit →add-other-agents
Add child agents, connected agents, or other multi-agent patterns to a Copilot Studio agent. Use when the user asks to create a sub-agent, child agent, connected agent, or call another agent.
Full instructions & audit →analyze-evals
Analyze exported evaluation results from Copilot Studio's Evaluate tab. The user provides a CSV file exported from the Copilot Studio UI; this skill parses it, identifies failures, and proposes YAML fixes. No API access or published agent required — just the exported CSV.
Full instructions & audit →chat-directline
Send a message to a Copilot Studio agent via DirectLine v3. Use for agents with no auth or manual auth. Requires a token endpoint URL or DirectLine secret.
Full instructions & audit →chat-sdk
Send a message to a Copilot Studio agent via the Copilot Studio Client SDK (M365). Use for agents with integrated auth (Entra ID SSO). Requires an App Registration Client ID.
Full instructions & audit →chat-with-agent
DEPRECATED: Use /copilot-studio:detect-mode then /copilot-studio:chat-directline or /copilot-studio:chat-sdk instead.
Full instructions & audit →clone-agent
Clone a Copilot Studio agent from the cloud. Guides through environment selection, agent selection, and downloads agent YAML files.
Full instructions & audit →create-eval
Create plugin development eval scenarios (JSON files with natural prompts and deterministic checks for testing plugin skills). NOT for Copilot Studio in-product evaluation — use /copilot-studio:create-eval-set for that.
Full instructions & audit →create-eval-set
Create a test set CSV file for import into Copilot Studio's in-product Evaluate tab. Reads the agent's topics, instructions, and knowledge sources to generate meaningful test cases with appropriate graders (General quality, Compare meaning, Exact match, etc.). Use when the user asks to create, prepare, or generate evaluation test cases for their agent.
Full instructions & audit →detect-mode
Detect a Copilot Studio agent's authentication mode (DirectLine vs M365) by querying Dataverse. Returns the mode and connection details needed to chat.
Full instructions & audit →directline-chat
DEPRECATED: Use /copilot-studio:chat-with-agent instead — it auto-detects DirectLine vs M365 mode. This skill is kept for backwards compatibility only.
Full instructions & audit →edit-action
Edit an existing action (TaskDialog) in a Copilot Studio agent. Supports connector actions and MCP server actions. Modify inputs, outputs, descriptions, connection mode, and other properties.
Full instructions & audit →edit-agent
Edit Copilot Studio agent settings, instructions, or configuration. Use when the user asks to change agent instructions, display name, conversation starters, AI settings, or generative actions toggle.
Full instructions & audit →edit-triggers
Modify topic triggers — trigger phrases and model description. Use when the user asks to add, remove, or change trigger phrases, or edit a topic's model description.
Full instructions & audit →int-patterns
Pattern library for Copilot Studio agent design. Contains proven and recommended implementation patterns with YAML examples. Used by the Advisor agent to suggest patterns and by the Author agent to reference YAML structure during implementation. USE FOR: design guidance, pattern suggestions, review against best practices, troubleshooting known pitfalls, YAML reference during implementation. DO NOT USE FOR: general YAML schema reference (use int-reference), topic creation mechanics (use new-topic
Full instructions & audit →int-project-context
🔥🔥✓ VerifiedShared project context for all Copilot Studio sub-agents. Provides project structure, schema lookup usage, and skill invocation guidance.
Full instructions & audit →int-reference
🔥🔥🔥✓ VerifiedReference tables for Copilot Studio YAML authoring: triggers, actions, variables, entities, Power Fx functions, templates. Preloaded by author and advisor agents.
Full instructions & audit →list-kinds
List all available kind discriminator values from the Copilot Studio YAML schema. Use when the user asks what kinds/types are available.
Full instructions & audit →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.
Full instructions & audit →lookup-schema
Look up Copilot Studio YAML schema definitions. Use when the user asks about schema structure, element properties, or how to use a specific YAML kind.
Full instructions & audit →manage-agent
Push/pull Copilot Studio agent content via the VS Code extension's LanguageServerHost LSP binary. Handles authentication (interactive browser login for push/pull, device code flow for chat token), sync push, sync pull, clone, and diff operations.
Full instructions & audit →new-topic
Create a new Copilot Studio topic YAML file. Use when the user asks to create a new topic, conversation flow, or dialog for their agent.
Full instructions & audit →run-eval
Run evaluations against a Copilot Studio agent via the Power Platform Evaluation API. Works on DRAFT agents — no publish step required. Lists test sets, starts a run, polls until complete, fetches results, and proposes YAML fixes for failures. Use when the user wants to test agent changes without publishing.
Full instructions & audit →run-tests-kit
Run a batch test suite via the Copilot Studio Kit (Dataverse API). Uses the Power CAT Copilot Studio Kit to execute test cases against a published agent and produces pass/fail results with latencies. Requires the Kit installed in the environment, an App Registration with Dataverse permissions, and a published agent.
Full instructions & audit →test-auth
Authenticate for Copilot Studio evaluation API and SDK chat. Caches a token that is shared across run-eval and chat-sdk skills. Run this before any eval or SDK chat workflow. Requires an App Registration with MakerOperations and Copilots.Invoke permissions.
Full instructions & audit →validate
Validate Copilot Studio agent YAML files using the LSP binary's full diagnostics (YAML structure, Power Fx, schema, cross-file references). Use when the user asks to check, validate, or verify YAML files.
Full instructions & audit →⌁ sub-agents (4)
⌁ also included
- Hooks — automations that run on events (e.g. before/after every edit or commit)
Skills for Copilot Studio
A plugin for Claude Code, GitHub Copilot CLI, and VS Code that enables authoring, testing, and troubleshooting Microsoft Copilot Studio agents through YAML files — directly from your terminal or editor.
Disclaimer
This plugin is an experimental research project, not an officially supported Microsoft product. The Copilot Studio YAML schema may change without notice. Always review and validate generated YAML before pushing to your environment — AI-generated output may contain errors or unsupported patterns.
Prerequisites
- Claude Code, GitHub Copilot CLI, or VS Code
- Node.js 18+
- VS Code with the Copilot Studio Extension (required for push/pull/clone operations)
Installation
From marketplace (Claude Code / GitHub Copilot CLI)
/plugin marketplace add microsoft/skills-for-copilot-studio
/plugin install copilot-studio@skills-for-copilot-studioFrom VS Code Extensions Store (GitHub Copilot)
Search for Skills for Copilot Studio in the VS Code Extensions using the @agentPlugins filter to view and click Install.

From a local clone
git clone https://github.com/microsoft/skills-for-copilot-studio.git
# Load for a single session
claude --plugin-dir /path/to/skills-for-copilot-studio
# Or install persistently (user-wide)
claude plugin install /path/to/skills-for-copilot-studio --scope user
# Or install for a specific project
claude plugin install /path/to/skills-for-copilot-studio --scope projectUpdating
The update process depends on how you installed the plugin:
| Interface | Update Method | Details |
|---|---|---|
| Claude Code CLI | Auto-update (recommended) | Marketplace plugins update automatically. No action needed. |
| GitHub Copilot CLI | Manual | Run /plugin update skills-for-copilot-studio in an interactive session, or copilot plugin update skills-for-copilot-studio from the terminal. |
| VS Code | Extension auto-update | VS Code handles updates automatically when extension auto-update is enabled in settings. |
Usage
The plugin provides four sub-agents, each backed by a specialized agent:
/copilot-studio:copilot-studio-manage Clone, push, pull, and sync agent content between local files and the cloud
/copilot-studio:copilot-studio-author Create and edit YAML (topics, actions, knowledge, triggers, variables)
/copilot-studio:copilot-studio-test Test published agents — point-tests, batch suites, or evaluation analysis
/copilot-studio:copilot-studio-advisor Design guidance, agent review, and troubleshootingQuick Start
# Clone an agent from the cloud (guided flow — opens browser for sign-in)
/copilot-studio:copilot-studio-manage clone
# Design and build topics
/copilot-studio:copilot-studio-author Create a topic that handles IT service requests
# Pull latest, push your changes
/copilot-studio:copilot-studio-manage pull
/copilot-studio:copilot-studio-manage push
# Publish in Copilot Studio UI, then test
/copilot-studio:copilot-studio-test Send "How do I request a new laptop?" to the published agent
# Get design advice and review
/copilot-studio:copilot-studio-advisor Review my agent for improvements and known pitfallsSee SETUP_GUIDE.md for a full end-to-end walkthrough including validation, testing options, and troubleshooting.
One install gets you everything — 31 skills, 4 sub-agents, hooks — kept up to date together.
Licensed under MIT— you can use, modify, and redistribute it under that license's terms.
View the full license file on GitHub →