typespec-create-agent
Generate a complete TypeSpec declarative agent with instructions, capabilities, and conversation starters for Microsoft 365 Copilot
Profile →npx skills add github/awesome-copilot --skill typespec-create-agent --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 Declarative Agent Create a complete TypeSpec declarative agent for Microsoft 365 Copilot with the following structure: ## Requirements Generate a `main.tsp` file with: 1. **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 2. **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 3. **Conversation Starters** - Include 2-4 `@conversationStarter` decorators - Each with a title and example query - Make them diverse and showcase different capabilities 4. **Capabilities** (based on user needs) - `WebSearch` - for web content with optional site scoping - `OneDriveAndSharePoint` - for document access with URL filtering - `TeamsMessages` - for Teams channel/chat access - `Email` - for email access with folder filtering - `People` - for organization people search - `CodeInterpreter` - for Python code execution - `GraphicArt` - for image generation - `GraphConnectors` - for Copilot connector con
- Requirements
- Template Structure
- Best Practices
- Examples
What does the typespec-create-agent skill do?
Generate a complete TypeSpec declarative agent with instructions, capabilities, and conversation starters for Microsoft 365 Copilot
How do I install it?
Run `npx skills add github/awesome-copilot --skill typespec-create-agent --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.