typespec-create-agent

Generate TypeSpec agent definitions for Microsoft 365 Copilot with decorators and scoped capabilities.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/BrunoAMSilva/my-config --skill typespec-create-agent-brunoamsilva
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: typespec-create-agent
Source: https://github.com/BrunoAMSilva/my-config/tree/main/coding/skills/typespec-create-agent
Command: npx skills add https://github.com/BrunoAMSilva/my-config --skill typespec-create-agent-brunoamsilva

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generates complete TypeSpec declarative agent definitions for Microsoft 365 Copilot to remove repetitive boilerplate and ensure correct decorator usage, capability declarations, and scoped access rules.

Core Features & Use Cases

  • Template Generation: Produces a ready-to-use main.tsp with imports, @agent declaration, @instructions, @conversationStarter entries, and capability operations.
  • Capability Scoping: Supports WebSearch, OneDriveAndSharePoint, TeamsMessages, Email, People, CodeInterpreter, GraphicArt, GraphConnectors, Dataverse, and Meetings with guidance on URL/folder scoping and filters.
  • Best-practice Guidance: Enforces name and description length limits, recommends instruction style and safety scoping, and provides diverse conversation starters to showcase agent capabilities.

Quick Start

Generate a TypeSpec agent called Customer Support Assistant with WebSearch, Email, and OneDriveAndSharePoint capabilities, include three conversation starters, and output a complete main.tsp with imports, decorators, and scoped capabilities.

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 TypeSpec declarative agent for Microsoft 365 Copilot?

To create a TypeSpec declarative agent for Microsoft 365 Copilot, generate a main.tsp file using the @agent, @instructions, and @conversationStarter decorators alongside scoped capability operations for your desired integrations.

What capabilities can I declare in a TypeSpec Microsoft 365 Copilot agent?

TypeSpec Microsoft 365 Copilot agents support capability operations for WebSearch, OneDriveAndSharePoint, TeamsMessages, Email, People, CodeInterpreter, GraphicArt, GraphConnectors, Dataverse, and Meetings, allowing scoped access to specific resources.

Does TypeSpec agent generation enforce length limits for Microsoft 365 Copilot declarations?

Yes, TypeSpec agent generation enforces strict name and description length limits within the @agent decorator to ensure compliance with Microsoft 365 Copilot declarative agent requirements and best practices.

How do I add conversation starters to a TypeSpec Copilot agent?

You add conversation starters to a TypeSpec Copilot agent by applying the @conversationStarter decorator, typically generating between two and four entries to effectively showcase the agent's distinct capabilities.

Can I scope OneDriveAndSharePoint and Email capabilities in a TypeSpec agent?

Yes, TypeSpec agent generation supports capability scoping for OneDriveAndSharePoint and Email, requiring scoped parameters like specific URLs or folders to limit Microsoft 365 Copilot access to relevant resources.

What imports and decorators are required for a complete TypeSpec agent file?

A complete TypeSpec agent file requires a namespace, necessary imports, and the @agent, @instructions, and @conversationStarter decorators to properly define the declarative Microsoft 365 Copilot structure.