typespec-create-api-plugin
Generate a TypeSpec API plugin with REST operations, authentication, and Adaptive Cards for Microsoft 365 Copilot
Profile →npx skills add github/awesome-copilot --skill typespec-create-api-plugin --agent copilot
Same command for any agent — swap --agent for claude-code, codex, cursor.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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 ```typescript 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; @agent({ name: "[Agent Name]", description: "[Description]" }) @instructions(""" [Instructions for using the API operations] """) namespace [AgentName] { // Reference operations from actions.tsp op operation1 is [APINamespace].operationName; } ``` ### actions.tsp - API Operations ```typescript import "@typespec/http"; import "@microsoft/typespec-m365-copilot"; using TypeSpec.Http; using TypeSpec.M365.Copilot.Actions; @service @actions(#{ nameForHuman: "[API Display Name]", descriptionForModel: "[Model description]", descriptionForHuman: "[User description]" }) @server("[API_BASE_URL]", "[API Name]") @useAuth([AuthType]) // Optional namespace [APINamespace] { @route("[/path]") @get @action op operationName( @path param1: string, @query param2?: strin
- Requirements
- main.tsp - Agent Definition
- actions.tsp - API Operations
- Authentication Options
- Function Capabilities
- Confirmation Dialog
- Adaptive Card Response
- Reasoning & Response Instructions
- Best Practices
- Workflow
What does the typespec-create-api-plugin skill do?
Generate a TypeSpec API plugin with REST operations, authentication, and Adaptive Cards for Microsoft 365 Copilot
How do I install it?
Run `npx skills add github/awesome-copilot --skill typespec-create-api-plugin --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From github/awesome-copilot, a repository with 37,432 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.