From copilot-studio
Edits Copilot Studio agent configurations in agent.mcs.yml and settings.mcs.yml including instructions, display name, conversation starters, AI models, and generative actions. Auto-discovers via Glob.
How this skill is triggered — by the user, by Claude, or both
Slash command
/copilot-studio:edit-agent <what to change><what to change>copilot-studio-authorThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Modify agent metadata (`agent.mcs.yml`) or configuration (`settings.mcs.yml`).
Modify agent metadata (agent.mcs.yml) or configuration (settings.mcs.yml).
Auto-discover the agent directory:
Glob: **/agent.mcs.yml
NEVER hardcode an agent name. If multiple agents found, ask which one.
Identify what the user wants to change and read the appropriate file:
agent.mcs.ymlsettings.mcs.ymlIf the user wants to change the AI model, run the schema lookup tool first:
node ${CLAUDE_SKILL_DIR}/../../scripts/schema-lookup.bundle.js models
Use the output to determine the correct modelNameHint and provider values.
CRITICAL: Do NOT include kind in the model block — the agent-level schema uses CurrentModelsNoKind.
Read the current file before making any changes.
Make the requested changes using the Edit tool.
agent.mcs.yml| Field | Description | Example |
|---|---|---|
displayName | Agent's display name | displayName: My Agent |
instructions | System prompt / personality | Multi-line YAML with | |
conversationStarters | Suggested conversation starters | Array of {title, text} |
aISettings.model.modelNameHint | Model hint (run models command for convention) | Sonnet46, GPT5Chat |
aISettings.model.provider | Model provider (required for non-OpenAI) | Anthropic |
settings.mcs.yml| Field | Description | Example |
|---|---|---|
GenerativeActionsEnabled | Enable generative orchestration | true / false |
authenticationMode | Auth mode | Integrated, None |
authenticationTrigger | When to auth | Always, AsNeeded |
accessControlPolicy | Access control | ChatbotReaders |
configuration.aISettings.* | AI capabilities | Various booleans |
configuration.settings.*.content.capabilities.webBrowsing | Web browsing | true / false |
For detailed guidance on writing knowledge-aware instructions, grounding directives, citation control, and scope enforcement, see instructions-guide.md.
schemaName — This is the internal Power Platform identifier. Changing it breaks the agent.publishedOn — Managed by the platform.template — Managed by the platform.language — Changing this can corrupt the agent.If the user asks to change any of these, warn them.
instructions: |
You are a customer support agent for Contoso Ltd.
Guidelines:
- Be professional and empathetic
- Always verify the customer's identity first
- Escalate billing issues to a human agent
npx claudepluginhub microsoft/skills-for-copilot-studio --plugin copilot-studioFixes, improves, or updates existing Claude Code custom agents (subagents). Diagnoses common issues like poor descriptions, wrong models, missing tools, and applies frontmatter edits.
Edits existing TaskDialog actions in Copilot Studio agents. Supports connector and MCP server actions. Modifies inputs, outputs, descriptions, connection mode, and properties using YAML files.
Builds, edits, or analyzes Agent Skills via conversational discovery of personas, capabilities, and memory. Auto-activates on 'Create an Agent', 'Analyze an Agent', or 'Edit an Agent' requests.