microsoft/skills/edit-agent
skills/edit-agent/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add microsoft/skills-for-copilot-studio skills/edit-agentInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 30, 2026, 7:04 AM11.1s2 files scanned
SKILL.md
- user-invocable:
- false
- description:
- 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.
- argument-hint:
- <what to change>
- allowed-tools:
- Bash(node *schema-lookup.bundle.js *), Read, Edit, Glob
- context:
- fork
- agent:
- copilot-studio-author
Edit Agent Settings/Instructions
Modify agent metadata (agent.mcs.yml) or configuration (settings.mcs.yml).
Instructions
-
Auto-discover the agent directory:
Glob: **/agent.mcs.ymlNEVER hardcode an agent name. If multiple agents found, ask which one.
-
Identify what the user wants to change and read the appropriate file:
- Instructions, display name, conversation starters, AI settings →
agent.mcs.yml - GenerativeActionsEnabled, authentication, recognizer, capabilities →
settings.mcs.yml
- Instructions, display name, conversation starters, AI settings →
-
If the user wants to change the AI model, run the schema lookup tool first:
node ${CLAUDE_SKILL_DIR}/../../scripts/schema-lookup.bundle.js modelsUse the output to determine the correct
modelNameHintandprovidervalues. CRITICAL: Do NOT includekindin the model block — the agent-level schema usesCurrentModelsNoKind. -
Read the current file before making any changes.
-
Make the requested changes using the Edit tool.
Editable Fields in 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 |
Editable Fields in 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 |
Writing Effective Instructions
For detailed guidance on writing knowledge-aware instructions, grounding directives, citation control, and scope enforcement, see instructions-guide.md.
Fields to NEVER Modify
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.
Example: Update Instructions
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
Related Skills
microsoft/int-patterns
development
VerifiedTrustedCommunity
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).
378SKILL.mdUpdated Jul 26, 2026
microsoft/skills/lookup-schema
testing
VerifiedTrustedCommunity
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.
378SKILL.mdUpdated Apr 30, 2026
microsoft/int-reference
data-ai
VerifiedTrustedCommunity
Reference tables for Copilot Studio YAML authoring: triggers, actions, variables, entities, Power Fx functions, templates. Preloaded by author and advisor agents.
378SKILL.mdUpdated Apr 30, 2026
microsoft/skills/add-knowledge
development
VerifiedTrustedCommunity
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.
378SKILL.mdUpdated Apr 30, 2026