{"id":"162e0328-3bf7-48b5-b999-5f7c36b90a55","shortId":"mJtSAd","kind":"skill","title":"typespec-create-agent","tagline":"Generate a complete TypeSpec declarative agent with instructions, capabilities, and conversation starters for Microsoft 365 Copilot","description":"# Create TypeSpec Declarative Agent\n\nCreate a complete TypeSpec declarative agent for Microsoft 365 Copilot with the following structure:\n\n## Requirements\n\nGenerate a `main.tsp` file with:\n\n1. **Agent Declaration**\n   - Use `@agent` decorator with a descriptive name and description\n   - Name should be 100 characters or less\n   - Description should be 1,000 characters or less\n\n2. **Instructions**\n   - Use `@instructions` decorator with clear behavioral guidelines\n   - Define the agent's role, expertise, and personality\n   - Specify what the agent should and shouldn't do\n   - Keep under 8,000 characters\n\n3. **Conversation Starters**\n   - Include 2-4 `@conversationStarter` decorators\n   - Each with a title and example query\n   - Make them diverse and showcase different capabilities\n\n4. **Capabilities** (based on user needs)\n   - `WebSearch` - for web content with optional site scoping\n   - `OneDriveAndSharePoint` - for document access with URL filtering\n   - `TeamsMessages` - for Teams channel/chat access\n   - `Email` - for email access with folder filtering\n   - `People` - for organization people search\n   - `CodeInterpreter` - for Python code execution\n   - `GraphicArt` - for image generation\n   - `GraphConnectors` - for Copilot connector content\n   - `Dataverse` - for Dataverse data access\n   - `Meetings` - for meeting content access\n\n## Template Structure\n\n```typescript\nimport \"@typespec/http\";\nimport \"@typespec/openapi3\";\nimport \"@microsoft/typespec-m365-copilot\";\n\nusing TypeSpec.Http;\nusing TypeSpec.M365.Copilot.Agents;\n\n@agent({\n  name: \"[Agent Name]\",\n  description: \"[Agent Description]\"\n})\n@instructions(\"\"\"\n  [Detailed instructions about agent behavior, role, and guidelines]\n\"\"\")\n@conversationStarter(#{\n  title: \"[Starter Title 1]\",\n  text: \"[Example query 1]\"\n})\n@conversationStarter(#{\n  title: \"[Starter Title 2]\",\n  text: \"[Example query 2]\"\n})\nnamespace [AgentName] {\n  // Add capabilities as operations here\n  op capabilityName is AgentCapabilities.[CapabilityType]<[Parameters]>;\n}\n```\n\n## Best Practices\n\n- Use descriptive, role-based agent names (e.g., \"Customer Support Assistant\", \"Research Helper\")\n- Write instructions in second person (\"You are...\")\n- Be specific about the agent's expertise and limitations\n- Include diverse conversation starters that showcase different features\n- Only include capabilities the agent actually needs\n- Scope capabilities (URLs, folders, etc.) when possible for better performance\n- Use triple-quoted strings for multi-line instructions\n\n## Examples\n\nAsk the user:\n1. What is the agent's purpose and role?\n2. What capabilities does it need?\n3. What knowledge sources should it access?\n4. What are typical user interactions?\n\nThen generate the complete TypeSpec agent definition.","tags":["typespec","create","agent","awesome","copilot","github","agent-skills","agents","custom-agents","github-copilot","hacktoberfest","prompt-engineering"],"capabilities":["skill","source-github","skill-typespec-create-agent","topic-agent-skills","topic-agents","topic-awesome","topic-custom-agents","topic-github-copilot","topic-hacktoberfest","topic-prompt-engineering"],"categories":["awesome-copilot"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/github/awesome-copilot/typespec-create-agent","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add github/awesome-copilot","source_repo":"https://github.com/github/awesome-copilot","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 33270 github stars · SKILL.md body (2,761 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:52:27.064Z","embedding":null,"createdAt":"2026-04-18T20:26:12.070Z","updatedAt":"2026-05-18T18:52:27.064Z","lastSeenAt":"2026-05-18T18:52:27.064Z","tsv":"'-4':108 '000':68,101 '1':45,67,220,224,317 '100':60 '2':72,107,229,233,326 '3':103,332 '365':19,33 '4':125,339 '8':100 'access':142,150,154,181,186,338 'actual':291 'add':236 'agent':4,10,24,30,46,49,83,92,200,202,205,211,254,273,290,321,350 'agentcap':244 'agentnam':235 'ask':314 'assist':259 'base':127,253 'behavior':79,212 'best':247 'better':301 'capabilitynam':242 'capabilitytyp':245 'capabl':13,124,126,237,288,294,328 'channel/chat':149 'charact':61,69,102 'clear':78 'code':166 'codeinterpret':163 'complet':7,27,348 'connector':175 'content':134,176,185 'convers':15,104,280 'conversationstart':109,216,225 'copilot':20,34,174 'creat':3,21,25 'custom':257 'data':180 'datavers':177,179 'declar':9,23,29,47 'decor':50,76,110 'defin':81 'definit':351 'descript':53,56,64,204,206,250 'detail':208 'differ':123,284 'divers':120,279 'document':141 'e.g':256 'email':151,153 'etc':297 'exampl':116,222,231,313 'execut':167 'expertis':86,275 'featur':285 'file':43 'filter':145,157 'folder':156,296 'follow':37 'generat':5,40,171,346 'graphconnector':172 'graphicart':168 'guidelin':80,215 'helper':261 'imag':170 'import':190,192,194 'includ':106,278,287 'instruct':12,73,75,207,209,263,312 'interact':344 'keep':98 'knowledg':334 'less':63,71 'limit':277 'line':311 'main.tsp':42 'make':118 'meet':182,184 'microsoft':18,32 'microsoft/typespec-m365-copilot':195 'multi':310 'multi-lin':309 'name':54,57,201,203,255 'namespac':234 'need':130,292,331 'onedriveandsharepoint':139 'op':241 'oper':239 'option':136 'organ':160 'paramet':246 'peopl':158,161 'perform':302 'person':88,266 'possibl':299 'practic':248 'purpos':323 'python':165 'queri':117,223,232 'quot':306 'requir':39 'research':260 'role':85,213,252,325 'role-bas':251 'scope':138,293 'search':162 'second':265 'shouldn':95 'showcas':122,283 'site':137 'skill' 'skill-typespec-create-agent' 'sourc':335 'source-github' 'specif':270 'specifi':89 'starter':16,105,218,227,281 'string':307 'structur':38,188 'support':258 'team':148 'teamsmessag':146 'templat':187 'text':221,230 'titl':114,217,219,226,228 'topic-agent-skills' 'topic-agents' 'topic-awesome' 'topic-custom-agents' 'topic-github-copilot' 'topic-hacktoberfest' 'topic-prompt-engineering' 'tripl':305 'triple-quot':304 'typescript':189 'typespec':2,8,22,28,349 'typespec-create-ag':1 'typespec.http':197 'typespec.m365.copilot.agents':199 'typespec/http':191 'typespec/openapi3':193 'typic':342 'url':144,295 'use':48,74,196,198,249,303 'user':129,316,343 'web':133 'websearch':131 'write':262","prices":[{"id":"eb41f977-3815-48c1-8da0-835b7f8ab292","listingId":"162e0328-3bf7-48b5-b999-5f7c36b90a55","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"github","category":"awesome-copilot","install_from":"skills.sh"},"createdAt":"2026-04-18T20:26:12.070Z"}],"sources":[{"listingId":"162e0328-3bf7-48b5-b999-5f7c36b90a55","source":"github","sourceId":"github/awesome-copilot/typespec-create-agent","sourceUrl":"https://github.com/github/awesome-copilot/tree/main/skills/typespec-create-agent","isPrimary":false,"firstSeenAt":"2026-04-18T21:51:30.367Z","lastSeenAt":"2026-05-18T18:52:27.064Z"},{"listingId":"162e0328-3bf7-48b5-b999-5f7c36b90a55","source":"skills_sh","sourceId":"github/awesome-copilot/typespec-create-agent","sourceUrl":"https://skills.sh/github/awesome-copilot/typespec-create-agent","isPrimary":true,"firstSeenAt":"2026-04-18T20:26:12.070Z","lastSeenAt":"2026-05-07T22:40:18.967Z"}],"details":{"listingId":"162e0328-3bf7-48b5-b999-5f7c36b90a55","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"github","slug":"typespec-create-agent","github":{"repo":"github/awesome-copilot","stars":33270,"topics":["agent-skills","agents","ai","awesome","custom-agents","github-copilot","hacktoberfest","prompt-engineering"],"license":"mit","html_url":"https://github.com/github/awesome-copilot","pushed_at":"2026-05-18T01:26:59Z","description":"Community-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.","skill_md_sha":"dd691ea774938a80b6d1d07c7962db772a5f051f","skill_md_path":"skills/typespec-create-agent/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/github/awesome-copilot/tree/main/skills/typespec-create-agent"},"layout":"multi","source":"github","category":"awesome-copilot","frontmatter":{"name":"typespec-create-agent","description":"Generate a complete TypeSpec declarative agent with instructions, capabilities, and conversation starters for Microsoft 365 Copilot"},"skills_sh_url":"https://skills.sh/github/awesome-copilot/typespec-create-agent"},"updatedAt":"2026-05-18T18:52:27.064Z"}}