microsoft/skills-for-copilot-studio

Skills for Copilot Studio – What It Is

Skills for Copilot Studio is a plugin that lets you work with Microsoft Copilot Studio agents directly from the command line or VS Code. It adds four sub‑commands that let you:

1. Manage an agent’s source files (clone, pull, push, sync) between your local machine and the Copilot Studio cloud.
2. Author the agent’s YAML definition (topics, actions, knowledge, triggers, variables) using a guided, AI‑assisted flow.
3. Test a published agent with point‑tests, batch suites, or evaluation analysis.
4. Get advice – design guidance, review, and troubleshooting from a specialized “advisor” sub‑agent.

The plugin works with three front‑ends:

• Claude Code (Anthropic’s CLI for Claude)
• GitHub Copilot CLI
• VS Code (via the Copilot Studio extension)

It is an experimental research project, not an officially supported Microsoft product, and the underlying YAML schema may evolve.

---

Quick‑Start Workflow

# 1. Clone an existing agent from the cloud (opens a sign‑in page)
/copilot-studio:copilot-studio-manage clone

# 2. Author a new topic (e.g., handling IT service requests)
/copilot-studio:copilot-studio-author Create a topic that handles IT service requests

# 3. Keep the local copy in sync
/copilot-studio:copilot-studio-manage pull
/copilot-studio:copilot-studio-manage push

# 4. Test the published agent
/copilot-studio:copilot-studio-test Send "How do I request a new laptop?" to the published agent

# 5. Ask the advisor for design feedback
/copilot-studio:copilot-studio-advisor Review my agent for improvements and known pitfalls

The full end‑to‑end guide is in SETUP_GUIDE.md.

---

Installation Options

Interface	How to Install
Claude Code CLI	/plugin marketplace add microsoft/skills-for-copilot-studio && /plugin install copilot-studio@skills-for-copilot-studio
GitHub Copilot CLI	Search for Skills for Copilot Studio in the VS Code Extensions Store using the @agentPlugins filter and click Install.
VS Code	Clone the repo locally and load it with claude --plugin-dir <path> or install persistently with claude plugin install <path> --scope user (or project).

Updates follow the host platform: auto‑update in Claude Code, manual plugin update in Copilot CLI, or VS Code’s normal extension update mechanism.

---

Who Might Use It?

• Copilot Studio developers who prefer a terminal‑first workflow.
• Teams building “standard” agents (the YAML‑based agent type) and needing quick sync, testing, and design advice.
• Experimenters who want to prototype agents without leaving their editor or CLI.

---

Caveats

• The plugin is experimental; the YAML schema can change without notice.
• AI‑generated YAML should always be reviewed before pushing to production.
• Not an officially supported Microsoft product.

---

Contributing

See CONTRIBUTING.md for instructions on building the plugin, running tests, and submitting pull requests.