typespec-api-operations Skill: Add API Operations to TypeSpec, and How to Install It

Adds GET, POST, PATCH and DELETE operations to an existing TypeSpec API plugin for Microsoft 365 Copilot.

Installs: 8.8K; on skills.sh
Stars: 40.7K; on GitHub
Updated: Oct 2026; last repo commit

This skill gives your assistant ready-made TypeSpec patterns for each HTTP verb. They cover routes, query, path and body parameters, confirmation cards, and Adaptive Cards for GET results.

It applies when you ask to add operations to a TypeSpec API plugin. The folder holds only SKILL.md, and the SKILL.md names no API key or tool. It assumes the plugin already exists.

Good for

Developers building API plugins for Microsoft 365 Copilot with TypeSpec
Teams adding create, update and delete actions that need a confirmation card
Anyone who wants GET results shown as an Adaptive Card

Install typespec-api-operations

Claude Code

1
Download the skill folder from https://github.com/github/awesome-copilot/tree/HEAD/skills/typespec-api-operations.
2
Put it at ~/.claude/skills/typespec-api-operations/ so that SKILL.md sits directly inside.
3
Start a new session; the skill loads when its description matches the task.

Pick one route. The Copilot plugin route installs typespec-m365-copilot, which lists 3 skills (typespec-api-operations, typespec-create-agent, typespec-create-api-plugin) and no agents, hooks or MCP servers in its plugin.json. The skills CLI and folder routes install only typespec-api-operations.

Built from the package data we hold. Not yet tested by us.

What's in the skill

When it loads

Add GET, POST, PATCH, and DELETE operations to a TypeSpec API plugin with proper routing, parameters, and adaptive cards

Sections in SKILL.md

Adding GET Operations
Simple GET - List All Items
GET with Query Parameter - Filter Results
GET with Path Parameter - Get Single Item
GET with Adaptive Card
Adding POST Operations
Simple POST - Create Item
POST with Confirmation
Adding PATCH Operations
Simple PATCH - Update Item
PATCH with Confirmation
Adding DELETE Operations
Simple DELETE
DELETE with Confirmation
Complete CRUD Example
Define the Service and Models

Key facts

Author: Awesome Copilot Community (listed as the plugin author)
License: MIT
Installs on skills.sh: 8,777 (Nov 2, 2026)
GitHub stars: 40,666 for the whole github/awesome-copilot repo (Nov 2, 2026)
Last repo commit: Oct 30, 2026
Audits on skills.sh: Gen Agent Trust Hub: pass, Socket: pass, Snyk: pass
What it includes: 1 file including SKILL.md
Part of: Copilot plugin typespec-m365-copilot: 3 skills (typespec-api-operations, typespec-create-agent, typespec-create-api-plugin)
Works in: The SKILL.md names no client; the repo README documents installing its plugins with Copilot CLI

What it includes

List all, filter by query, fetch one by path ID, or show as an Adaptive Card.
Four patterns. The card version points to a file such as appPackage/item-card.json that you create next to the operation.
Try: “Add a listItems operation that filters by userId and shows results as a card”
Write · GET operations
Create an item, plain or with a confirmation card.
The confirmation card lists the values Copilot is about to send.
Write · POST operations
Update an item, plain or with a confirmation card.
The confirmation card shows the item ID and the new title and status.
Write · PATCH operations
Remove an item, plain or with a confirmation card.
The confirmation text in the SKILL.md ends with "This action cannot be undone."
Try: “Add a deleteItem operation with a confirmation”
Write · DELETE operations
A full ItemsAPI service with models for create, read, update and delete.
Defines the service, the Item model and the request and response models in one namespace.
Complete CRUD example
Several query parameters, header parameters, custom response models, error responses.
Four short patterns for cases beyond the basic verbs.
Advanced features
Sample prompts for each verb to try in Copilot after you add operations.
For example "List all items and show them in a table" and "Delete item 99".
Testing prompts
Naming, models, confirmations, cards, routing, plus four common problems.
The common problems are a missing parameter, a card that does not render, a missing confirmation and a missing model property.
Best practices and common issues

From the official docs

Permissions

Low risk

It adds operations and card files to your TypeSpec project, so a wrong edit lands in your own code. Read the diff before you build or deploy.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It adds code to your TypeSpec project
The skill has the assistant add operations and Adaptive Card files to your project. Review the diff before you build or deploy. github.com
Its examples include a DELETE operation
The DELETE examples ship with a confirmation card that says the action cannot be undone. Keep that card when you adapt them. github.com

Technical details

Turning on read-only	No read-only mode. The skill exists to add operations to your project.
Scopes	Edits the TypeSpec files and Adaptive Card JSON in your API plugin project

Questions

What does typespec-api-operations do?

It gives your assistant TypeSpec patterns for adding GET, POST, PATCH and DELETE operations to an existing API plugin for Microsoft 365 Copilot. The patterns cover routes, query, path and body parameters, confirmation cards for create, update and delete, and Adaptive Cards for GET results.

How do I install it?

Use the install box above. The Copilot CLI tab installs the typespec-m365-copilot plugin, which also adds typespec-create-agent and typespec-create-api-plugin. The skills CLI and folder routes install only this skill.

Does it need an API key or any tools?

The SKILL.md names no API key, tool or script, and the folder holds only SKILL.md. Your TypeSpec project and Microsoft 365 Copilot setup come from somewhere else; this skill assumes an API plugin already exists.

Is it safe to use?

It bundles no scripts. It does tell the assistant to add operations to your TypeSpec project, so read the diff before you build or deploy. The DELETE examples include a confirmation card, so keep it when you adapt them.

How is it different from typespec-create-api-plugin?

typespec-create-api-plugin generates a whole TypeSpec API plugin with REST operations, authentication and Adaptive Cards (its SKILL.md). This skill only adds operations to a plugin that already exists.

Which assistants does it work in?

The SKILL.md names no client. The repo README documents Copilot CLI for its plugins, and the skills CLI and folder routes in the install box place the skill for other agents that read SKILL.md files.

Information

updated Nov 2, 2026

Repository: github/awesome-copilot
Folder: skills/typespec-api-operations

github/awesome-copilot skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4

typespec-api-operations SKILL.md · github.com
awesome-copilot README · github.com
plugin.json · github.com
SKILL.md · github.com