PlugWiki

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. 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. 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

  1. Requirements
  2. Project Setup
  3. Key Files Generated
  4. MCP Server Integration
  5. Supported MCP Endpoints
  6. Tool Selection
  7. Authentication Types
  8. Response Semantics
  9. Define Data Mapping
  10. Add Adaptive Cards (Optional)
  11. Environment Configuration
  12. Testing & Deployment
  13. Local Testing
  14. Validation
  15. Best Practices
  16. Tool Design

Key facts

Installs on skills.sh
8,704 (Nov 2, 2026)
Last repo commit
Oct 30, 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 setup

  • manifest.json, declarativeAgent.json, ai-plugin.json and .vscode/mcp.json

    Each is shown as a JSON template in SKILL.md.

    Write · Generated key files

  • Server metadata, tools listing and tool execution endpoints

    Tools are fetched from the server, then you select which to include.

    MCP server requirements

  • OAuth 2.0 with static registration, or single sign-on

    OAuth uses a reference ID plus client ID and secret from environment variables.

    Write · Authentication

  • Maps fields from API results to title, subtitle and URL

    Adaptive Cards are optional and handled by the mcp-create-adaptive-cards prompt.

    Response semantics

  • Writes OAUTH_REFERENCE_ID, CLIENT_ID and CLIENT_SECRET to .env.local or .env.dev

    These are the credential values you supply.

    Write · Environment configuration

  • Provision, debug to sideload in Teams, then test in Microsoft 365 Copilot

    SKILL.md names m365.cloud.microsoft/chat for testing.

    Testing and validation

  • Four 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
  • Creates and edits project files such as appPackage/*.json and .vscode/mcp.json

  • Writes OAuth client ID and secret placeholders to .env.local

  • Connects an agent to an MCP server URL you give it

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

Folder
skills/mcp-create-declarative-agent

github/awesome-copilotskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4
  1. awesome-copilot README · github.com
  2. mcp-m365-copilot plugin.json · github.com
  3. mcp-create-declarative-agent SKILL.md · github.com
  4. mcp-m365-agent-expert agent · github.com

Updated Nov 2, 2026.