What it does
Generate a complete TypeSpec declarative agent with instructions, capabilities, and conversation starters for Microsoft 365 Copilot
Skills ZICQ category:Agent Workflows typespec-create-agent
Generate a complete TypeSpec declarative agent with instructions, capabilities, and conversation starters for Microsoft 365 Copilot
Official URL:skills.sh
Intro in this page language first. The official description stays in its original wording; we do not rewrite SKILL.md.
Generate a complete TypeSpec declarative agent with instructions, capabilities, and conversation starters for Microsoft 365 Copilot
The official description does not include a separate “Use when”. Per the spec, agents activate this skill when the task matches keywords in that description.
Per Agent Skills progressive disclosure: name and description load at startup (~100 tokens); the full SKILL.md body loads when the skill activates; scripts/, references/, and assets/ load only as needed. This file's sections: Create TypeSpec Declarative Agent; Requirements; Template Structure; Best Practices; Examples. It includes spec-recommended sections: input/output examples.
File analysis: instruction-only skill (SKILL.md). The agent loads the full body when activated.
Create TypeSpec Declarative AgentRequirementsTemplate StructureBest PracticesExamples
Source category:skills.sh agent-skill
nametypespec-create-agentdescriptionInvocation syntax and available tools depend on your Agent client. Client integration guide ↗
Choose the target agent and installation scope, keep referenced package files, then verify the skill appears in the client's catalog.
Copy these instructions to a compatible agent and confirm the target directory matches your client.
Install the agent skill "typespec-create-agent" into my project. The full SKILL.md and official description are at https://zicq.com/en/skills/skl-e60d6fbf3cb5bf1f-Typespec-Create-Agent.html Save it as .cursor/skills/typespec-create-agent/SKILL.md or .claude/skills/typespec-create-agent/SKILL.md and keep the frontmatter name and description exactly as-is.
Requires Node.js and npx. First inspect the repository's skill list to confirm the name.
npx skills add 'https://github.com/github/awesome-copilot' --list
npx skills add 'https://github.com/github/awesome-copilot' --skill 'typespec-create-agent'
The CLI lets you choose the agent interactively. The default scope is the project; use -g for user scope. Confirm package availability with the discovery command, then use npx skills list to inspect installed skills.
Create a complete TypeSpec declarative agent for Microsoft 365 Copilot with the following structure:
Generate a main.tsp file with:
Agent Declaration
@agent decorator with a descriptive name and descriptionInstructions
@instructions decorator with clear behavioral guidelinesConversation Starters
@conversationStarter decoratorsCapabilities (based on user needs)
WebSearch - for web content with optional site scopingOneDriveAndSharePoint - for document access with URL filteringTeamsMessages - for Teams channel/chat accessEmail - for email access with folder filteringPeople - for organization people searchCodeInterpreter - for Python code executionGraphicArt - for image generationGraphConnectors - for Copilot connector contentDataverse - for Dataverse data accessMeetings - for meeting content accessimport "@typespec/http";
import "@typespec/openapi3";
import "@microsoft/typespec-m365-copilot";
using TypeSpec.Http;
using TypeSpec.M365.Copilot.Agents;
@agent({
name: "[Agent Name]",
description: "[Agent Description]"
})
@instructions("""
[Detailed instructions about agent behavior, role, and guidelines]
""")
@conversationStarter(#{
title: "[Starter Title 1]",
text: "[Example query 1]"
})
@conversationStarter(#{
title: "[Starter Title 2]",
text: "[Example query 2]"
})
namespace [AgentName] {
// Add capabilities as operations here
op capabilityName is AgentCapabilities.[CapabilityType]<[Parameters]>;
}
Ask the user:
Then generate the complete TypeSpec agent definition.
Agent Workflows
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that exte…
Agent Workflows
Use the ClawdHub CLI to search, install, update, and publish agent skills from clawdhub.com. Use when you need to fetch new skills on the fl…
Agent Workflows
Orchestrate multi-agent teams with defined roles, task lifecycles, handoff protocols, and review workflows. Use when: (1) Setting up a team …
Agent Workflows
Spec-first, TDD, subagent-driven software development workflow. Use when: (1) building any new feature or app — triggers brainstorm → plan →…