MCP Declarative Agent Skill (awesome-copilot) for Claude Code: What It Does and How to Install It
Makes your agent build a Microsoft 365 Copilot declarative agent that talks to an MCP server, from manifest files to sign-in setup.
- Installs
- 8.7K
- on skills.sh
- Stars
- 40.7K
- on GitHub
- Updated
- Oct 2026
- last repo commit
This skill is a converted prompt. Its SKILL.md wraps the original prompt in a code fence, and the frontmatter description only says it was converted from mcp-create-declarative-agent.prompt.md. The agent asks you five questions (the MCP server URL, which tools to expose, the auth method, the agent's purpose and whether you need response semantics or cards), then generates the appPackage files, a .vscode/mcp.json and an .env.local template.
It bundles no scripts. Setup uses the Microsoft 365 Agents Toolkit to scaffold the agent, add the MCP action, select tools and set authentication, and it ends with provisioning and testing steps.
Good for
- Developers extending Microsoft 365 Copilot with their own MCP server
- Teams using the Microsoft 365 Agents Toolkit in VS Code
- Anyone choosing OAuth 2.0 or single sign-on for an agent action
Install mcp-create-declarative-agent
Claude Code
- 1
Copy this prompt.
Install the mcp-create-declarative-agent skill in Claude Code. Run this command: npx skills add https://github.com/github/awesome-copilot --skill mcp-create-declarative-agent Then check that it loaded and tell me how to use it.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js.
The awesome-copilot README is written for GitHub Copilot and does not name Claude Code, so the Claude Code and Codex routes are the standard skill-folder routes. The mcp-m365-copilot plugin lists 3 skills and 1 agent in its plugin.json. The agent file has no tool list in its frontmatter.
Built from the package data we hold. Not yet tested by us. Source.
What's in the skill
When it loads
Skill converted from mcp-create-declarative-agent.prompt.md
Sections in SKILL.md
- Requirements
- Project Setup
- Key Files Generated
- MCP Server Integration
- Supported MCP Endpoints
- Tool Selection
- Authentication Types
- Response Semantics
- Define Data Mapping
- Add Adaptive Cards (Optional)
- Environment Configuration
- Testing & Deployment
- Local Testing
- Validation
- Best Practices
- Tool Design
Key facts
- Installs on skills.sh
- 8,704 (Nov 2, 2026)
- Last repo commit
- Oct 30, 2026
- What it includes
- 1 file: SKILL.md. No scripts
- Audits on skills.sh
- Gen Agent Trust Hub: pass, Socket: pass, Snyk: pass (Nov 2, 2026)
What it includes
Five steps: scaffold the agent, add an MCP action, select tools, set auth, review files
Uses Microsoft 365 Agents Toolkit.
Write ·
Project setupmanifest.json, declarativeAgent.json, ai-plugin.json and .vscode/mcp.json
Each is shown as a JSON template in SKILL.md.
Write ·
Generated key filesServer metadata, tools listing and tool execution endpoints
Tools are fetched from the server, then you select which to include.
MCP server requirementsOAuth 2.0 with static registration, or single sign-on
OAuth uses a reference ID plus client ID and secret from environment variables.
Write ·
AuthenticationMaps fields from API results to title, subtitle and URL
Adaptive Cards are optional and handled by the mcp-create-adaptive-cards prompt.
Response semanticsWrites OAUTH_REFERENCE_ID, CLIENT_ID and CLIENT_SECRET to .env.local or .env.dev
These are the credential values you supply.
Write ·
Environment configurationProvision, debug to sideload in Teams, then test in Microsoft 365 Copilot
SKILL.md names m365.cloud.microsoft/chat for testing.
Testing and validationFour best-practice groups and four troubleshooting cases
Covers tool design, security, instructions and performance.
Best practices and troubleshooting
From the official docs
Permissions
Medium risk
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It writes OAuth secrets to env files
SKILL.md has the agent create .env.local or .env.dev with OAUTH_REFERENCE_ID, CLIENT_ID and CLIENT_SECRET. Keep that file out of git and enter real values yourself. github.com
The agent can call every tool you expose
SKILL.md says to select specific tools to import and to limit scopes to the minimum. Expose only the tools the agent needs. github.com
The Copilot plugin also adds an agent and two skills
plugin.json for mcp-m365-copilot lists 3 skills and the agent file mcp-m365-agent-expert.md, whose frontmatter lists no tools. Install this skill alone if you only want it. github.com
Technical details
| Scopes |
|
|---|
Questions
What does mcp-create-declarative-agent do?
It makes your agent generate a Microsoft 365 Copilot declarative agent that uses an MCP server. That means the manifest and plugin files, an MCP config, auth setup and provisioning steps.
How do I install it?
Use the install box at the top of this page. In GitHub Copilot CLI it also comes with the mcp-m365-copilot plugin.
Do I need an MCP server first?
Yes. The first question the agent asks is which MCP server and URL you are integrating, and the server must provide metadata, tools listing and tool execution endpoints.
Which sign-in methods does it cover?
OAuth 2.0 with static registration and single sign-on. SKILL.md recommends OAuth 2.0 for production and storing secrets in environment variables.
What about Adaptive Cards?
They are an optional extra. SKILL.md points to a separate mcp-create-adaptive-cards prompt, and the plugin.json for mcp-m365-copilot lists a skill with that name.
Is it safe?
It bundles no scripts. It writes project files and an env file for OAuth credentials, so keep that file out of version control and review the tools you expose to the agent.
Does it work in Claude Code?
The file is a standard SKILL.md and installs like any other skill. Its embedded prompt header names Copilot tools, and nothing in the repo says it was tested in Claude.
Information
updated Nov 2, 2026
- Repository
- github/awesome-copilot
- Folder
skills/mcp-create-declarative-agent
Sources
Docs, issue trackers and discussions this page is built from.
Show all 4Hide
- awesome-copilot README · github.com
- mcp-m365-copilot plugin.json · github.com
- mcp-create-declarative-agent SKILL.md · github.com
- mcp-m365-agent-expert agent · github.com