MR
Mayur Rathi
@github
⭐ 34.1k GitHub stars

Declarative-Agents-Microsoft365

Declarative-Agents-Microsoft365是一款code方向的AI技能，核心价值是Comprehensive development guidelines for Microsoft 365 Copilot declarative agents with schema v1，可用于解决开发者在code领域的实际问题，帮助用户提升效率、自动化重复任务或优化工作流。

Comprehensive development guidelines for Microsoft 365 Copilot declarative agents with schema v1.5, TypeSpec integration, and Microsoft 365 Agents Toolkit workflows

Last verified on: 2026-05-30
mkdir -p ./skills/declarative-agents-microsoft365 && curl -sfL https://raw.githubusercontent.com/github/awesome-copilot/main/skills/declarative-agents-microsoft365/SKILL.md -o ./skills/declarative-agents-microsoft365/SKILL.md

Run in terminal / PowerShell. Requires curl (Unix) or PowerShell 5+ (Windows).

Skill Content

# Microsoft 365 Declarative Agents Development Guidelines


Overview


Microsoft 365 Copilot declarative agents are powerful custom AI assistants that extend Microsoft 365 Copilot with specialized capabilities, enterprise data access, and custom behaviors. These guidelines provide comprehensive development practices for creating production-ready agents using the latest v1.5 JSON schema specification with full Microsoft 365 Agents Toolkit integration.


Schema Specification v1.5


Core Properties


json 
{
  "$schema": "https://developer.microsoft.com/json-schemas/copilot/declarative-agent/v1.5/schema.json",
  "version": "v1.5",
  "name": "string (max 100 characters)",
  "description": "string (max 1000 characters)", 
  "instructions": "string (max 8000 characters)",
  "capabilities": ["array (max 5 items)"],
  "conversation_starters": ["array (max 4 items, optional)"]
}

Character Limits & Constraints

- **Name**: Maximum 100 characters, required

- **Description**: Maximum 1000 characters, required

- **Instructions**: Maximum 8000 characters, required

- **Capabilities**: Maximum 5 items, minimum 1 item

- **Conversation Starters**: Maximum 4 items, optional


Available Capabilities


Core Capabilities

1. **WebSearch**: Internet search and real-time information access

2. **OneDriveAndSharePoint**: File access, document search, content management

3. **GraphConnectors**: Enterprise data integration from third-party systems

4. **MicrosoftGraph**: Access to Microsoft 365 services and data


Communication & Collaboration

5. **TeamsAndOutlook**: Teams chat, meetings, email integration

6. **CopilotForMicrosoft365**: Advanced Copilot features and workflows


Business Applications

7. **PowerPlatform**: Power Apps, Power Automate, Power BI integration

8. **BusinessDataProcessing**: Advanced data analysis and processing

9. **WordAndExcel**: Document creation, editing, analysis

10. **EnterpriseApplications**: Third-party business system integration

11. **CustomConnectors**: Custom API and service integrations


Microsoft 365 Agents Toolkit Integration


VS Code Extension Setup

bash 
# Install Microsoft 365 Agents Toolkit
# Extension ID: teamsdevapp.ms-teams-vscode-extension

TypeSpec Development Workflow


#### 1. Modern Agent Definition

typespec 
import "@typespec/json-schema";

using TypeSpec.JsonSchema;

@jsonSchema("/schemas/declarative-agent/v1.5/schema.json")
namespace DeclarativeAgent;

/** Microsoft 365 Declarative Agent */
model Agent {
  /** Schema version */
  @minLength(1)
  $schema: "https://developer.microsoft.com/json-schemas/copilot/declarative-agent/v1.5/schema.json";
  
  /** Agent version */
  version: "v1.5";
  
  /** Agent name (max 100 characters) */
  @maxLength(100)
  @minLength(1)
  name: string;
  
  /** Agent description (max 1000 characters) */
  @maxLength(1000)
  @minLength(1)  
  description: string;
  
  /** Agent instructions (max 8000 characters) */
  @maxLength(8000)
  @minLength(1)
  instructions: string;
  
  /** Agent capabilities (1-5 items) */
  @minItems(1)
  @maxItems(5)
  capabilities: AgentCapability[];
  
  /** Conversation starters (max 4 items) */
  @maxItems(4)
  conversation_starters?: ConversationStarter[];
}

/** Available agent capabilities */
union AgentCapability {
  "WebSearch",
  "OneDriveAndSharePoint", 
  "GraphConnectors",
  "MicrosoftGraph",
  "TeamsAndOutlook",
  "PowerPlatform",
  "BusinessDataProcessing",
  "WordAndExcel",
  "CopilotForMicrosoft365",
  "EnterpriseApplications",
  "CustomConnectors"
}

/** Conversation starter definition */
model ConversationStarter {
  /** Starter text (max 100 characters) */
  @maxLength(100)
  @minLength(1)
  text: string;
}

#### 2. Compilation to JSON

bash 
# Compile TypeSpec to JSON manifest
tsp compile agent.tsp --emit=@typespec/json-schema

Environment Configuration


#### Development Environment

json 
{
  "name": "${DEV_AGENT_NAME}",
  "description": "Development version: ${AGENT_

🎯 Best For

  • UI designers
  • Product designers
  • Claude users
  • GitHub Copilot users
  • Software engineers

💡 Use Cases

  • Generating component mockups
  • Creating design system tokens
  • Code quality improvement
  • Best practice enforcement

📖 How to Use This Skill

  1. 1

    Install the Skill

    Copy the install command from the Terminal tab and run it. The SKILL.md file downloads to your local skills directory.

  2. 2

    Load into Your AI Assistant

    Open Claude or GitHub Copilot and reference the skill. Paste the SKILL.md content or use the system prompt tab.

  3. 3

    Apply Declarative-Agents-Microsoft365 to Your Work

    Open your project in the AI assistant and ask it to apply the skill. Start with a small module to verify the output quality.

  4. 4

    Review and Refine

    Review AI suggestions before committing. Run tests, check for regressions, and iterate on the skill output.

❓ Frequently Asked Questions

Does this work with Figma?

Some design skills integrate with Figma plugins. Check the Works With section for supported tools.

Is Declarative-Agents-Microsoft365 compatible with Cursor and VS Code?

Yes — this skill works with any AI coding assistant including Cursor, VS Code with Copilot, and JetBrains IDEs.

Do I need specific dependencies for Declarative-Agents-Microsoft365?

Check the install command and Works With section. Most code skills only require the AI assistant and your codebase.

How do I install Declarative-Agents-Microsoft365?

Copy the install command from the Terminal tab and run it. The skill downloads to ./skills/declarative-agents-microsoft365/SKILL.md, ready to use.

Can I customize this skill for my team?

Absolutely. Edit the SKILL.md file to add team-specific instructions, examples, or workflows.

⚠️ Common Mistakes to Avoid

Skipping usability testing

AI-generated designs should be validated with real users before development.

Skipping validation

Always test AI-generated code changes, even for simple refactors.

Missing dependency updates

Check if the skill requires updated dependencies or new packages.

🔗 Related Skills

00-andruia-consultant 00-andruia-consultant007 00710-andruia-skill-smith 10-andruia-skill-smith20-andruia-niche-intelligence 20-andruia-niche-intelligencea11y A11Yaccessibility Accessibility Expert