Skip to content
Get packs

Microsoft 365 Declarative Agents Kit

Guides building and validating Microsoft 365 Copilot declarative agents using the v1.5 schema and TypeSpec

Source Download skill
Repository
github/awesome-copilot
Stars
40,703
Licence
MIT
Files
1 file

What it does

This skill turns your AI agent into a guide for building Microsoft 365 Copilot declarative agents, which are custom Copilot assistants configured with a manifest rather than custom code. It offers three workflows: a basic creation path for simple prototypes, an advanced path for enterprise design (localization, deployment, monitoring), and a validation path that checks an existing agent against the v1.5 schema limits such as name (100), description (1000) and instructions (8000) characters. It also explains TypeSpec as an alternative way to write definitions and points to the Microsoft 365 Agents Toolkit for VS Code.

Great for

  • Developers new to Microsoft 365 Copilot who want step-by-step help creating a declarative agent
  • Teams reviewing or troubleshooting an existing agent manifest against schema limits
  • Developers who want to migrate JSON manifests to TypeSpec

Skip it if

  • Non-developers or people who do not use Microsoft 365, since the output is only useful inside that ecosystem
  • Anyone relying on the schema details without checking them, because the file gives no source links and the v1.5 rules may have changed since it was written

Try asking

  • “Help me plan a basic declarative agent for our HR team that answers policy questions from SharePoint”
  • “Validate my existing agent JSON manifest against the v1.5 character and array limits”
  • “Convert this agent JSON into TypeSpec definitions”
  • “Set up local testing for my agent with Agents Playground”
Step-by-step guide: how to use Microsoft 365 Declarative Agents KitInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    declarative-agents.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip declarative-agents.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip declarative-agents.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Provide your agent's current JSON manifest or requirements up front so the validation and planning steps have concrete input
  • Check the schema details (v1.5 limits, the list of 11 capabilities, the max of 5 capabilities and 4 conversation starters) against current Microsoft documentation before relying on them
  • Use the Agents Toolkit and Agents Playground to test changes before deploying to a tenant

What's inside

  • SKILL.md

Redistributed unmodified from github/awesome-copilot under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.