How microsoft/skills-for-copilot-studio works
Skills for Copilot Studio is an editor/CLI plugin for authoring, synchronizing, testing, and troubleshooting standard Copilot Studio agents as YAML. Its main user workflow is to clone or pull agent files, author changes, validate or push them, then test a published agent and review results. The graph preserves the four documented sub-agents and the major authoring, management, test, and guidance capabilities. Script relationships use the shown source excerpts and SOURCE INDEX; unsampled skill internals are represented by their exact directories.
Main entry points: copilot-studio-author.md Author Agent · chat-with-agent.js Published-Agent Chat · shared-auth.js Shared Authentication · manage-agent.js Sync & Validation CLI
Components 22
Specialist Agents
- Manage Agent
agents/copilot-studio-manage.md - Author Agent
agents/copilot-studio-author.md - Test Agent
agents/copilot-studio-test.md - Advisor Agent
agents/copilot-studio-advisor.md
Authoring Guidance
- Authoring Skills
skills - YAML Templates
templates - Design Patterns
patterns - Schemas & Connectors
reference
Agent Operations
- Sync & Validation CLI
scripts/src/manage-agent.js - Published-Agent Chat
scripts/src/chat-with-agent.js - DirectLine Client
scripts/src/directline-chat.js - Evaluation API Client
scripts/src/eval-api.js - Schema Lookup
scripts/src/schema-lookup.js - Connector Lookup
scripts/src/connector-lookup.js
CLI Runtime
- Shared Authentication
scripts/src/shared-auth.js - Secure Token Cache
scripts/src/msal-cache.js - HTTP & Chat Utilities
scripts/src/shared-utils.js
Other components
- Plugin User
- Copilot Studio
- Power Platform APIs
- DirectLine Service
- Claude / Copilot / VS Code
Connections 29
- Plugin User → Manage Agent: requests sync
README.md - Plugin User → Author Agent: requests authoring
README.md - Plugin User → Test Agent: requests testing
README.md - Plugin User → Advisor Agent: requests guidance
README.md - Claude / Copilot / VS Code → Manage Agent: hosts plugin
README.md - Claude / Copilot / VS Code → Author Agent: hosts plugin
README.md - Manage Agent → Sync & Validation CLI: invokes sync
README.md - Author Agent → Authoring Skills: uses skills
README.md - Author Agent → YAML Templates: authors from
- Author Agent → Design Patterns: consults
- Author Agent → Schemas & Connectors: consults
- Test Agent → Published-Agent Chat: tests agent
README.md - Test Agent → Evaluation API Client: runs evaluations
README.md - Advisor Agent → Design Patterns: uses guidance
- Sync & Validation CLI → Shared Authentication: acquires tokens
scripts/src/manage-agent.js - Sync & Validation CLI → Copilot Studio: syncs via LSP
scripts/src/manage-agent.js - Sync & Validation CLI → Power Platform APIs: resolves environment
scripts/src/manage-agent.js - Published-Agent Chat → Shared Authentication: acquires tokens
scripts/src/chat-with-agent.js - Published-Agent Chat → HTTP & Chat Utilities: uses chat helpers
scripts/src/chat-with-agent.js - Published-Agent Chat → DirectLine Client: routes DirectLine mode
scripts/src/chat-with-agent.js - Published-Agent Chat → Power Platform APIs: detects auth mode
scripts/src/chat-with-agent.js - DirectLine Client → HTTP & Chat Utilities: uses protocol helpers
scripts/src/directline-chat.js - DirectLine Client → DirectLine Service: sends activities
- Evaluation API Client → Shared Authentication: acquires tokens
scripts/src/eval-api.js - Evaluation API Client → Power Platform APIs: calls evaluation API
scripts/src/eval-api.js - Schema Lookup → Power Platform APIs: looks up schemas
- Connector Lookup → Power Platform APIs: looks up connectors
- Shared Authentication → HTTP & Chat Utilities: logs through
scripts/src/shared-auth.js - Shared Authentication → Secure Token Cache: creates cache plugin
scripts/src/shared-auth.js