skills.rest
BrunoAMSilva
BrunoAMSilvaCOMMUNITY
Explore all skills by this author →
GitHub

typespec-create-api-plugin

Generate TypeSpec API plugin scaffolding with main.tsp and actions.tsp files.

Updated Apr 14, 2026
Search Tags:#typescript#authentication#rest#copilot#typespec#adaptive-cards#api-plugin
One-click install
npx skills add https://github.com/BrunoAMSilva/my-config --skill typespec-create-api-plugin-brunoamsilva
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: typespec-create-api-plugin
Source: https://github.com/BrunoAMSilva/my-config/tree/main/coding/skills/typespec-create-api-plugin
Command: npx skills add https://github.com/BrunoAMSilva/my-config --skill typespec-create-api-plugin-brunoamsilva

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

TypeSpec API plugin development for Copilot can be time-consuming and error-prone. This skill provides a guided blueprint to generate a complete plugin with REST operations, authentication, and Adaptive Cards, accelerating interoperability with external APIs.

Core Features & Use Cases

  • Create main.tsp with agent definition tailored for Copilot integration.
  • Create actions.tsp to expose RESTful operations and data models.
  • Optional assets for cards and documentation to support rich responses.

Quick Start

Generate the TypeSpec plugin scaffolding using the provided prompts to produce ready-to-use main.tsp and actions.tsp files.

Frequently Asked Questions about typespec-create-api-plugin

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a TypeSpec API plugin for Microsoft 365 Copilot?▼

To create a TypeSpec API plugin, generate scaffolding that outputs a cohesive project containing main.tsp and actions.tsp files. This automates agent definitions, RESTful operations, and authentication wiring for Copilot.

What is TypeSpec used for in Copilot API development?▼

TypeSpec defines OpenAPI-like RESTful endpoints and data models for Copilot. It generates API contracts needed to expose operations and integrate Adaptive Cards for rich Copilot responses.

Does a TypeSpec Copilot plugin support Adaptive Cards for responses?▼

Yes, a TypeSpec Copilot plugin supports Adaptive Cards. The generated project includes optional assets for cards and documentation to support rich, interactive Copilot responses.

How do I add authentication to a TypeSpec API plugin?▼

Authentication is automatically wired into the generated TypeSpec API plugin. The scaffolding process includes authentication setup within main.tsp and actions.tsp to secure RESTful operations.

Can I use TypeSpec to expose REST operations for external APIs in Copilot?▼

Yes, you can use TypeSpec to expose REST operations for external APIs. The generated actions.tsp file defines data models and RESTful endpoints to accelerate interoperability with external APIs.

What files are generated when scaffolding a TypeSpec API plugin?▼

Scaffolding a TypeSpec API plugin generates a cohesive project containing main.tsp, actions.tsp, and optional assets. These files provide agent definitions, operations, and card templates for developer workflows.

Related Skills

Explore More Software Engineering Skills→
lushly-devlushly-dev
4

afd-contracts

Generate OpenAPI, TypeScript, and Python Pydantic models from TypeSpec definitions.

Official
Advanced
lluppesmslluppesms

mcp-create-declarative-agent

Generate Microsoft 365 Copilot declarative agents with MCP server integration.

Community
Advanced
lluppesmslluppesms

typespec-create-api-plugin

Generate TypeSpec API plugin files for Microsoft 365 Copilot.

Community
Intermediate
GabeujinGabeujin

typespec-create-api-plugin

Generate TypeSpec API plugins for Microsoft 365 Copilot with REST operations and authentication.

Community
Intermediate