declarative-agents

Create and validate Microsoft 365 Copilot declarative agents using JSON manifests and TypeSpec definitions.

1|1|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/ultraviollettnympho/transit-ticket --skill declarative-agents-ultraviollettnympho
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: declarative-agents
Source: https://github.com/ultraviollettnympho/transit-ticket/tree/main/.github/skills/declarative-agents
Command: npx skills add https://github.com/ultraviollettnympho/transit-ticket --skill declarative-agents-ultraviollettnympho

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building Microsoft 365 Copilot declarative agents requires navigating the v1.5 schema, character limits, capability constraints, 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 of existing agents. - Schema v1.5 Compliance: Enforces character limits (name 100, description 1000, instructions 8000) and array constraints (max 4 conversation starters, max 5 capabilities). - 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 to build a Copilot agent that searches SharePoint and the web; the skill selects the right capabilities, generates a compliant manifest, and sets up local testing in Agents Playground. ## Quick Start Ask the assistant to create a Microsoft 365 Copilot declarative agent with WebSearch and OneDriveAndSharePoint capabilities and generate a compliant v1.5 manifest.

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 following the v1.5 schema. You can also write a TypeSpec definition that compiles to the JSON manifest and test locally with Agents Playground.

What capabilities are available for declarative agents?

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

What are the character limits in the declarative agent schema v1.5?

The v1.5 schema 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.

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 alongside local debugging with Agents Playground.

How do I test a declarative agent locally before deployment?

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