Typespec Create Agent

The typespec-create-agent skill generates a complete TypeSpec declarative agent configuration file for Microsoft 365 Copilot, including agent metadata, behavioral instructions, conversation starters, and capability declarations. It serves developers and organizations building custom Copilot agents by automating the creation of properly structured agent definitions that specify the agent's role, expertise, and available integrations with Microsoft 365 services. The skill solves the problem of manually writing and validating TypeSpec agent syntax by providing a guided generation process that ensures compliance with Copilot's agent requirements and best practices.

skills.sh installs: 8.7K
GitHub stars: 41K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add github/awesome-copilot --skill typespec-create-agent --agent claude-code

Installs into .claude/skills of the current project.

Files

Create TypeSpec Declarative Agent

Create a complete TypeSpec declarative agent for Microsoft 365 Copilot with the following structure:

Requirements

Generate a main.tsp file with:

Agent Declaration
- Use @agent decorator with a descriptive name and description
- Name should be 100 characters or less
- Description should be 1,000 characters or less
Instructions
- Use @instructions decorator with clear behavioral guidelines
- Define the agent's role, expertise, and personality
- Specify what the agent should and shouldn't do
- Keep under 8,000 characters
Conversation Starters
- Include 2-4 @conversationStarter decorators
- Each with a title and example query
- Make them diverse and showcase different capabilities