typespec-create-agent Skill: Write Microsoft 365 Copilot Agents in TypeSpec

Makes your agent write a TypeSpec declarative agent for Microsoft 365 Copilot, with instructions and conversation starters.

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

The output targets Microsoft 365 Copilot, so you need that platform to use the agent it writes. The skill makes your assistant ask four questions (the agent's purpose, its capabilities, its knowledge sources and typical user interactions) and then generate a main.tsp file.

The file has an @agent declaration, @instructions, 2 to 4 @conversationStarter decorators and the capabilities the agent needs. The template imports @typespec/http, @typespec/openapi3 and @microsoft/typespec-m365-copilot. This is a community skill from the awesome-copilot collection, not a Microsoft product.

Good for

Developers building declarative agents for Microsoft 365 Copilot
Teams that scope an agent to SharePoint, Teams, email or Dataverse
Anyone who wants a first main.tsp to edit

Install typespec-create-agent

Claude Code

Copy this prompt.

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

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

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.

Pick one route. The typespec-m365-copilot Copilot CLI plugin holds this skill and 2 other TypeSpec skills (3 skills, no agents in plugin.json). The skills CLI and folder routes install only this skill. The plugin folder on the main branch holds plugin.json and a README only, so check what the install adds.

From its listing on skills.sh. Source.

What's in the skill

When it loads

Generate a complete TypeSpec declarative agent with instructions, capabilities, and conversation starters for Microsoft 365 Copilot

Sections in SKILL.md

Requirements
Template Structure
Best Practices
Examples

Key facts

Author: Awesome Copilot Community (author listed in the plugin.json that includes it)
License: MIT (LICENSE: Copyright GitHub, Inc.)
Installs on skills.sh: 8,663 (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. It bundles no scripts
skills.sh audits: Gen Agent Trust Hub: pass; Socket: pass; Snyk: pass (Nov 2, 2026)
Needs: Microsoft 365 Copilot to run the agent it writes; the template imports the @typespec/http, @typespec/openapi3 and @microsoft/typespec-m365-copilot packages

What it includes

Purpose and role, capabilities, knowledge sources, typical interactions
Claude asks these before it writes the agent.
Ask four questions
Name up to 100 characters, description up to 1,000
Use role-based names such as "Customer Support Assistant".
Write · @agent declaration
Behaviour guidelines under 8,000 characters
Written in second person ("You are..."), with what the agent should and should not do.
Write · @instructions
2 to 4 starters, each with a title and an example query
They should show different capabilities.
Write · @conversationStarter
Picks from 10: WebSearch, OneDriveAndSharePoint, TeamsMessages, Email, People and 5 more
The full list also has CodeInterpreter, GraphicArt, GraphConnectors, Dataverse and Meetings. SKILL.md says to scope URLs and folders when possible.
Try: “Create a TypeSpec agent for our support team that can search our SharePoint docs”
Write · Capabilities

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

Capabilities decide what the agent can reach
The agent can be given Email, TeamsMessages, OneDriveAndSharePoint or Dataverse access. Keep only the ones you need and scope them to URLs or folders. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	No read-only mode. Use version control.
Sign-in and keys	SKILL.md does not mention any account or key.
Scopes	Writes a main.tsp file in your project

Questions

What does the typespec-create-agent skill do?

It makes your agent write a TypeSpec declarative agent for Microsoft 365 Copilot. The result is a main.tsp file with a name, instructions, conversation starters and capabilities.

Do I need Microsoft 365 Copilot?

The skill itself is a text file your assistant follows, but the agent it writes is for Microsoft 365 Copilot. You need that platform and the TypeSpec packages the template imports to use the result.

How do I install it in Claude Code?

Use the install box at the top of this page. The skills CLI route installs this skill alone, and the Copilot CLI plugin typespec-m365-copilot installs it with 2 other TypeSpec skills.

Which capabilities can the agent have?

SKILL.md lists 10: WebSearch, OneDriveAndSharePoint, TeamsMessages, Email, People, CodeInterpreter, GraphicArt, GraphConnectors, Dataverse and Meetings. It says to include only what the agent needs.

Does it deploy the agent?

SKILL.md only covers writing the TypeSpec definition. It does not describe building, publishing or deploying the agent.

Is it safe?

It bundles no scripts, and SKILL.md tells your agent to write a main.tsp file. Our advice: read the file before you build or publish it, especially the instructions and the capabilities it grants, such as Email or TeamsMessages.

Information

updated Nov 2, 2026

Repository: github/awesome-copilot
Folder: skills/typespec-create-agent

github/awesome-copilot skills.sh

Sources

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

Show all 4

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