TypeSpec API Plugin Skill (awesome-copilot) for Claude Code: What It Does and How to Install It

Makes your agent write a TypeSpec API plugin that lets Microsoft 365 Copilot call an external REST API.

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

The agent asks five questions (the API base URL and purpose, the operations needed, the auth method, which operations need confirmations and whether responses need Adaptive Cards), then writes main.tsp for the agent definition and actions.tsp for the API operations. It adds cards/card.json when you want cards.

SKILL.md shows the decorators to use, such as @agent, @actions, @server, @useAuth and @card. It bundles no scripts, and its code samples use bracketed placeholders such as [Agent Name] and [API_BASE_URL] for the agent to fill in.

Good for

Developers wrapping a REST API for Microsoft 365 Copilot
Teams that prefer TypeSpec over hand-written plugin JSON
Anyone adding confirmation prompts to risky API actions

Install typespec-create-api-plugin

Claude Code

Copy this prompt.

Install the typespec-create-api-plugin skill in Claude Code. Run this command:

npx skills add https://github.com/github/awesome-copilot --skill typespec-create-api-plugin

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

The awesome-copilot README is written for GitHub Copilot and does not name Claude Code, so the Claude Code and Codex routes are the standard skill-folder routes. The typespec-m365-copilot plugin lists 3 skills and no agents in its plugin.json. The plugin folder on the main branch holds plugin.json and a README only, so check what the install adds.

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

What's in the skill

When it loads

Generate a TypeSpec API plugin with REST operations, authentication, and Adaptive Cards for Microsoft 365 Copilot

Sections in SKILL.md

Requirements
main.tsp - Agent Definition
actions.tsp - API Operations
Authentication Options
Function Capabilities
Confirmation Dialog
Adaptive Card Response
Reasoning & Response Instructions
Best Practices
Workflow

Key facts

Author: Plugin author listed as Awesome Copilot Community
License: MIT (LICENSE file of the awesome-copilot repo)
Installs on skills.sh: 8,702 (Nov 2, 2026)
GitHub stars: 40,666 for the whole github/awesome-copilot repo (Nov 2, 2026)
Last repo commit: Oct 30, 2026
What it includes: 1 file: SKILL.md. No scripts
Audits on skills.sh: Gen Agent Trust Hub: pass, Socket: pass, Snyk: pass (Nov 2, 2026)
Part of: The typespec-m365-copilot plugin (3 skills listed in plugin.json)

What it includes

Agent definition with @agent, @instructions and operations
Imports @typespec/http, @typespec/openapi3 and @microsoft/typespec-m365-copilot.
Write · main.tsp
API operations, models and routes with @service, @actions, @server and @action
Uses @get, @post, @patch or @delete and @path, @query, @header and @body.
Write · actions.tsp
No auth, API key, OAuth2, or a registered auth reference
Four options, each with a @useAuth example.
Authentication options
Adds an Adaptive Card confirmation for destructive operations
Uses @capabilities with a confirmation block.
Write · Confirmation dialogs
Maps result lists to cards with @card and a cards/card.json file
Optional.
Adaptive Card responses
@reasoning and @responding guide how Copilot calls and presents results
Reasoning and response hints
Eight tips, from action-oriented operation names to confirmations for destructive actions
Best practices

From the official docs

Permissions

Low risk

What it can do

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

Watch out for

It writes auth details for your API
SKILL.md has examples for an API key header, OAuth2 URLs and scopes, and a registered auth reference ID. Put real keys and secrets in the platform's secure store, not in the .tsp files. github.com
Confirmations are optional
SKILL.md recommends confirmations for delete and critical update operations but asks you whether to add them. Say yes for anything destructive. github.com

Technical details

Scopes	Creates TypeSpec files in your project Writes auth settings for the API you name

Questions

What does typespec-create-api-plugin do?

It makes your agent write a TypeSpec API plugin for Microsoft 365 Copilot. It produces main.tsp, actions.tsp and, if you need them, Adaptive Card files.

How do I install it?

Use the install box at the top of this page. In GitHub Copilot CLI it also comes with the typespec-m365-copilot plugin.

What does the agent ask me first?

Five things: the API base URL and purpose, which operations you need, the auth method, whether any operations need confirmations, and whether responses need Adaptive Cards.

Which auth methods does it support?

No authentication, API key, OAuth2 and a registered auth reference. Each has an example decorator in SKILL.md.

What other skills sit next to it?

The plugin.json for typespec-m365-copilot also lists typespec-api-operations and typespec-create-agent.

Is it safe?

It bundles no scripts. It writes TypeSpec files into your project, so review the auth settings and add confirmations for any operation that deletes or changes data.

Does it work in Claude Code?

The file is a standard SKILL.md and installs like any other skill. The awesome-copilot README targets GitHub Copilot, and nothing in the repo says this skill was tested in Claude.

Information

updated Nov 2, 2026

Repository: github/awesome-copilot
Folder: skills/typespec-create-api-plugin

github/awesome-copilot skills.sh

Sources

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

Show all 3

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