typespec-create-agent

Generate TypeSpec declarative agent definitions for Microsoft 365 Copilot.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a declarative agent for Microsoft 365 Copilot in TypeSpec requires knowing the correct decorators, capability operations, and character limits, which is error-prone when done from scratch. ## Core Features & Use Cases - Agent Scaffolding: Produces a complete main.tsp file with @agent, @instructions, and @conversationStarter decorators following the required structure. - Capability Configuration: Adds operations for capabilities such as WebSearch, OneDriveAndSharePoint, TeamsMessages, Email, People, CodeInterpreter, GraphicArt, GraphConnectors, Dataverse, and Meetings. - Use Case: A developer needs a customer support agent for Microsoft 365 Copilot that searches the web and reads SharePoint documents; the Skill asks about purpose and capabilities, then outputs a ready-to-compile TypeSpec definition. ## Quick Start Ask the assistant to create a TypeSpec declarative agent for Microsoft 365 Copilot, describing its role, needed capabilities, and example conversation starters.

Frequently Asked Questions about typespec-create-agent

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

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

Define a namespace using the @agent decorator with a name and description, add @instructions for behavior, and include @conversationStarter entries. Import @microsoft/typespec-m365-copilot and declare capability operations inside the namespace.

What capabilities can a Microsoft 365 Copilot declarative agent have?

Available capabilities include WebSearch, OneDriveAndSharePoint, TeamsMessages, Email, People, CodeInterpreter, GraphicArt, GraphConnectors, Dataverse, and Meetings. Each is declared as an operation using AgentCapabilities types, optionally scoped with URLs or folders.

What are the character limits for a Copilot agent name and instructions?

The agent name must be 100 characters or less, the description 1,000 characters or less, and instructions must stay under 8,000 characters. Use triple-quoted strings for multi-line instruction text.

How many conversation starters should a declarative agent include?

Include 2 to 4 @conversationStarter decorators, each with a title and an example query. Make them diverse so they showcase different agent capabilities to end users.

When should I scope capabilities like WebSearch or OneDriveAndSharePoint?

Scope capabilities with specific site URLs or folder filters when the agent only needs a subset of content. Scoping improves relevance and performance compared to granting unfiltered access.