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/skills/validate
testing
VerifiedTrustedCommunity
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.
192SKILL.mdUpdated Apr 30, 2026
microsoft/skills/test-auth
development
VerifiedTrustedCommunity
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.
192SKILL.mdUpdated Apr 30, 2026
microsoft/skills/run-tests-kit
development
VerifiedTrustedCommunity
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.
192SKILL.mdUpdated Apr 30, 2026
microsoft/skills/run-eval
development
VerifiedTrustedCommunity
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.
192SKILL.mdUpdated Apr 30, 2026