typespec-create-agent

Overview

TypeSpec Create Agent is a skill that generates complete TypeSpec declarative agent definitions for Microsoft 365 Copilot. It produces a main.tsp file with agent metadata, behavioral instructions, conversation starters, and capability configurations for features like web search, OneDrive/SharePoint access, Teams messages, email, code execution, and more.

Key Features

• Agent Declaration - Generates @agent decorator with name (up to 100 characters) and description (up to 1,000 characters) following TypeSpec M365 Copilot conventions
• Behavioral Instructions - Creates detailed @instructions decorator content (up to 8,000 characters) defining the agent's role, expertise, personality, and boundaries
• Conversation Starters - Includes 2-4 diverse @conversationStarter decorators with titles and example queries that showcase different agent capabilities
• Rich Capability Configuration - Supports WebSearch with site scoping, OneDrive/SharePoint with URL filtering, Teams messages, email with folder filtering, People search, CodeInterpreter, GraphicArt, Graph Connectors, Dataverse, and Meetings
• TypeSpec Import Structure - Generates proper imports from @typespec/http, @typespec/openapi3, and @microsoft/typespec-m365-copilot with correct namespace usage

Who is this for?

This skill is for developers building declarative agents for Microsoft 365 Copilot using the TypeSpec definition language. It is particularly useful for enterprise developers who want to rapidly prototype and deploy custom Copilot agents with specific data source access and behavioral configurations without manually writing TypeSpec definitions from scratch.