typespec-create-api-plugin
Installation
Summary
Generate TypeSpec API plugins for Microsoft 365 Copilot with REST operations, authentication, and Adaptive Cards.
- Scaffolds complete TypeSpec projects with agent definitions (main.tsp) and API operations (actions.tsp) following Microsoft 365 Copilot conventions
- Supports four authentication modes: public APIs, API key headers, OAuth2 with authorization code flow, and registered auth references
- Includes optional confirmation dialogs for destructive operations and Adaptive Card templates for rich response formatting
- Provides decorators for operation reasoning, response instructions, and model definitions aligned with RESTful best practices
SKILL.md
Create TypeSpec API Plugin
Create a complete TypeSpec API plugin for Microsoft 365 Copilot that integrates with external REST APIs.
Requirements
Generate TypeSpec files with:
main.tsp - Agent Definition
import "@typespec/http";
import "@typespec/openapi3";
import "@microsoft/typespec-m365-copilot";
import "./actions.tsp";
using TypeSpec.Http;
using TypeSpec.M365.Copilot.Agents;
using TypeSpec.M365.Copilot.Actions;