typespec-create-api-plugin

SKILL.md

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

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;