M365 Declarative Agent Debugging Skill

Validate Microsoft 365 Copilot declarative agent manifests and diagnose common issues.

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

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, streamlining the development process and reducing frustration.

Core Features & Use Cases

  • Schema Validation: Verifies the structure and version compatibility of declarative agent manifests.
  • Troubleshooting: Diagnoses common issues like sideloading errors, conditional access blocks, and capability mismatches.
  • Knowledge Retrieval: Provides access to M365 Copilot development best practices and limitations.
  • Use Case: When a newly developed M365 Copilot agent fails to load or respond, this Skill can quickly identify if the issue is due to an incorrect schema version, missing capabilities, or manifest limits.

Quick Start

Use the M365 Declarative Agent Debugging Skill to troubleshoot an agent that is not responding.

Frequently Asked Questions about M365 Declarative Agent Debugging Skill

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

FAQPage Schema
Why does my M365 Copilot declarative agent fail to load or respond?

M365 Copilot declarative agents fail to load due to incorrect manifest schema versions, missing capabilities, or exceeding manifest limits. This Skill diagnoses these structural issues to restore agent functionality.

How do I troubleshoot Microsoft 365 Copilot agent sideloading errors?

Troubleshoot M365 Copilot agent sideloading errors by validating the declarative agent manifest structure and checking for capability mismatches. This process identifies structural flaws preventing successful agent deployment.

How do I validate a declarative agent manifest schema for Microsoft 365 Copilot?

Validate a declarative agent manifest schema by verifying its structure and version compatibility against M365 Copilot requirements. This ensures the manifest adheres to schema versions and capability limits.

What are the common limitations when developing M365 Copilot declarative agents?

Common limitations for M365 Copilot declarative agents include conditional access blocks, capability mismatches, and strict manifest limits. Understanding these constraints prevents non-functional agent deployments.

Can I debug Teams platform extensibility agents using this M365 Copilot troubleshooting approach?

Yes, this troubleshooting approach applies to both M365 Copilot and Teams platform extensibility development scenarios. It validates manifest structures and diagnoses common issues across both platforms.

What is the best way to diagnose non-functional Microsoft 365 Copilot agents?

The best way to diagnose non-functional M365 Copilot agents is to validate manifest structures and check for schema version incompatibilities. This quickly isolates structural errors causing agent failures.