M365 Declarative Agent Debugging

Validate M365 Copilot declarative agent schema versions, capabilities, manifest limits, and icons.

Updated Feb 2, 2026
One-click install
npx skills add https://github.com/fabioc-aloha/AlexCook --skill m365-declarative-agent-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: M365 Declarative Agent Debugging
Source: https://github.com/fabioc-aloha/AlexCook/tree/main/.github/skills/m365-agent-debugging
Command: npx skills add https://github.com/fabioc-aloha/AlexCook --skill m365-declarative-agent-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers debug non-functional Microsoft 365 Copilot declarative agents by identifying common issues related to schema versions, capability compatibility, manifest limits, and icon requirements.

Core Features & Use Cases

  • Schema Validation: Verifies correct schema versions and identifies non-existent ones.
  • Capability Compatibility Check: Ensures agent capabilities align with the chosen schema version.
  • Manifest Limit Adherence: Checks against defined limits for properties like conversation_starters and actions.
  • Icon Requirement Verification: Guides on correct icon dimensions and transparency.
  • Debugging Workflow: Provides a step-by-step process for validating and troubleshooting agents.
  • Use Case: If your M365 Copilot agent is not responding as expected, this skill can help you pinpoint whether the issue lies in an incorrect schema version, incompatible features, or improperly formatted icons.

Quick Start

Use the m365-agent-debugging skill to validate the schema version of a declarative agent.

Frequently Asked Questions about M365 Declarative Agent Debugging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why is my M365 Copilot declarative agent not responding?

M365 Copilot declarative agents fail to respond due to incorrect schema versions, incompatible capabilities, manifest limit violations, or improperly formatted icons. Validate your agent's manifest configuration against M365 Copilot extensibility standards to identify the specific failure point.

How do I validate the schema version for a Microsoft 365 Copilot agent?

Validate the schema version by checking your declarative agent manifest against supported M365 Copilot schemas. Ensure the declared version exists and aligns with your chosen capabilities to prevent deployment failures in Microsoft 365 environments.

What are the manifest limits for M365 declarative agent properties?

M365 declarative agent manifests enforce strict limits on properties like conversation_starters and actions. Verify your agent configuration adheres to these defined manifest limits to ensure successful deployment and proper Copilot extensibility behavior.

Does Teams Toolkit support debugging for M365 Copilot declarative agents?

Yes, Teams Toolkit supports M365 Copilot declarative agent development and debugging workflows. Use it alongside schema validation checks to identify non-functional agents, verify capability compatibility, and ensure manifest limits and icon requirements are met.

What are the icon requirements for M365 Copilot declarative agents?

M365 Copilot declarative agents require specific icon dimensions and proper transparency settings. Verify your manifest icons strictly adhere to these visual requirements to prevent agent rendering or deployment failures within Microsoft 365 environments.