declarative-agents

Create and validate Microsoft 365 Copilot declarative agents using JSON schema v1.5 and TypeSpec.

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/miyake-san/sogo-agent-platform --skill declarative-agents-miyake-san
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: declarative-agents
Source: https://github.com/miyake-san/sogo-agent-platform/tree/main/skills/core/declarative-agents
Command: npx skills add https://github.com/miyake-san/sogo-agent-platform --skill declarative-agents-miyake-san

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building Microsoft 365 Copilot declarative agents requires navigating the v1.5 manifest schema, capability constraints, character limits, and TypeSpec tooling, which is error-prone without structured guidance. ## Core Features & Use Cases - Three Guided Workflows: Basic agent creation for prototypes, advanced enterprise design with localization and deployment planning, and validation/optimization for existing agents. - Schema v1.5 Compliance: Enforces character limits (name 100, description 1000, instructions 8000) and array constraints (max 5 capabilities, max 4 conversation starters). - TypeSpec & Toolkit Integration: Generates type-safe TypeSpec definitions that compile to JSON and integrates with the Microsoft 365 Agents Toolkit VS Code extension and Agents Playground. - Use Case: A developer needs an enterprise agent that searches OneDrive and SharePoint; the Skill selects capabilities, generates a compliant manifest, and sets up local testing in Agents Playground. ## Quick Start Ask the agent to create a Microsoft 365 Copilot declarative agent manifest with WebSearch and OneDriveAndSharePoint capabilities using the basic workflow.

Frequently Asked Questions about declarative-agents

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

FAQPage Schema
How do I create a Microsoft 365 Copilot declarative agent?

Define the agent's purpose, select up to 5 capabilities such as WebSearch or OneDriveAndSharePoint, then generate a JSON manifest conforming to schema v1.5. You can also write a TypeSpec definition that compiles to the JSON manifest.

What capabilities are available for declarative agents?

There are 11 capabilities including WebSearch, OneDriveAndSharePoint, GraphConnectors, MicrosoftGraph, TeamsAndOutlook, PowerPlatform, and CustomConnectors. A single agent manifest can include a maximum of 5 capabilities.

Can I use TypeSpec instead of JSON for declarative agents?

Yes, TypeSpec provides type-safe agent definitions that compile to the JSON manifest format. The Microsoft 365 Agents Toolkit VS Code extension supports TypeSpec development with local debugging through Agents Playground.

What are the character limits for declarative agent manifests?

Schema v1.5 limits the name to 100 characters, the description to 1000 characters, and instructions to 8000 characters. Conversation starters are capped at 4 entries and capabilities at 5.

How do I test a declarative agent locally?

Use Agents Playground, which integrates with the Microsoft 365 Agents Toolkit VS Code extension, to run and debug agents locally. The toolkit also supports environment management across development, staging, and production.