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;
Related skills

More from github/awesome-copilot

Installs
8.4K
GitHub Stars
32.8K
First Seen
Feb 25, 2026