{"id":"5779fc04-682a-4302-982e-4d1d32c085fc","shortId":"zETNQt","kind":"skill","title":"workiq-copilot","tagline":"Guides the Copilot CLI on how to use the WorkIQ CLI/MCP server to query Microsoft 365 Copilot data (emails, meetings, docs, Teams, people) for live context, summaries, and recommendations.","description":"# WorkIQ Copilot Skill\n\n## Overview\n\nWorkIQ (Public Preview) lets Copilot query Microsoft 365 data with natural language. It supports schedules, documents, Teams messages, email threads, follow-up tracking, stakeholder summaries, and more. Use this skill whenever a task needs live organizational intelligence beyond the local repository.\n\n## Supported Data & Sample Prompts\n\n- **Emails** – “Summarize emails from Sarah about the budget.”\n- **Meetings** – “What are my upcoming meetings this week?”\n- **Documents** – “Find recent documents about Q4 planning.”\n- **Teams** – “Summarize messages in the Engineering channel today.”\n- **People/Projects** – “Who is working on Project Alpha?”\n\n## Getting Access\n\n1. **Copilot CLI plugin (preferred)**\n   - `copilot`\n   - `/plugin marketplace add github/copilot-plugins`\n   - `/plugin install workiq@copilot-plugins`\n   - Restart Copilot CLI.\n2. **Standalone CLI / MCP server**\n   - `npm install -g @microsoft/workiq` (or `npx -y @microsoft/workiq mcp`).\n   - Run `workiq mcp` to expose MCP tools if needed.\n3. **Tenant consent**\n   - First use prompts for Microsoft 365 admin consent (EULA + permissions). Non-admins must contact tenant admin to approve per the Tenant Administrator Enablement Guide.\n\n## Pre-flight Checklist\n\n- Run `Get-Command workiq` to ensure the binary is available.\n- Accept the EULA once via `workiq accept-eula`.\n- Confirm the correct tenant (`-t <tenant-id>` if different from default `common`).\n- Be ready to complete device login in the browser when prompted.\n\n## Core Workflow\n\n1. **Clarify intent** – agenda, action items, document lookup, people search, risk summary, etc.\n2. **Craft precise prompt** – include timeframe, source, or topic (e.g., “Summarize Teams posts in #eng for today”).\n3. **Run command** – `workiq ask --question \"<prompt>\"` (use `-q` for shorthand if desired).\n4. **Monitor execution** – long answers may stream; wait for the response to finish before issuing additional requests.\n5. **Summarize & redact** – highlight insights, note conflicts/tasks, avoid pasting raw links unless required.\n6. **Offer follow-ups** – blocking time, drafting notes, deeper queries, etc.\n\n## Command Reference\n\n| Command                           | Purpose                                                       |\n| --------------------------------- | ------------------------------------------------------------- |\n| `workiq --help`                   | Show global options.                                          |\n| `workiq version`                  | Display installed version.                                    |\n| `workiq accept-eula`              | Accept license (first use).                                   |\n| `workiq ask`                      | Interactive mode.                                             |\n| `workiq ask --question \"...\"`     | Ask a specific question (use `-q` shorthand if preferred).    |\n| `workiq ask -t <tenant> -q \"...\"` | Target a specific tenant.                                     |\n| `workiq mcp`                      | Start MCP stdio server (expose WorkIQ tools to other agents). |\n\n## Prompt Patterns\n\n- Agenda: “What’s on my calendar tomorrow?”\n- Action items: “Summarize follow-ups from today’s customer sync.”\n- Documents: “List PowerPoints about Contoso FY26 roadmap.”\n- Communications: “What did my manager say about the deadline?”\n- Insights: “What blockers came up in the last three meetings?”\n- Planning: “Suggest focus blocks for Tuesday afternoon.”\n\n## Response Guidelines\n\n- Keep summaries concise (2–3 sentences) calling out load, priorities, blockers, and optional next steps.\n- Refer to meetings/documents generically unless the user specifically needs links.\n- Mention if WorkIQ can continue (e.g., “WorkIQ can show Thu–Sun if needed”).\n- Map WorkIQ’s suggested actions to clear offers (block time, send follow-up, request recording, run deeper query).\n\n## Best Practices\n\n- Prefer narrow prompts to reduce noise; run multiple queries if needed.\n- Combine outputs logically (agenda + conflicts + action items) before responding.\n- Respect privacy: do not expose attendee lists or confidential snippets unless explicitly requested.\n- Log which commands were run so future steps can reference them (“Asked WorkIQ for agenda + conflicts”).\n- Use MCP mode (`workiq mcp`) when another agent/workflow needs direct tool access.\n\n## Troubleshooting\n\n- **Missing CLI** – install via npm or ensure PATH is set; notify user if unavailable.\n- **Consent/auth errors** – re-run command after admin grants permissions or after completing device login.\n- **Long/incomplete output** – rerun with refined scope or ask for specific data slices (per day/project/person).\n- **Command hanging** – cancel the running command in your terminal (for example, with Ctrl+C) or restart the Copilot CLI session, then retry; ensure browser login completed.\n\n## Follow-up Actions to Offer\n\n- Block focus/overflow holds at suggested times.\n- Draft reschedule/decline messages referencing WorkIQ guidance.\n- Request recordings or summaries for overlapping sessions.\n- Capture action items into task trackers.\n- Run additional WorkIQ queries (by project, stakeholder, time range) for deeper analysis.","tags":["workiq","copilot","awesome","github","agent-skills","agents","custom-agents","github-copilot","hacktoberfest","prompt-engineering"],"capabilities":["skill","source-github","skill-workiq-copilot","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/workiq-copilot","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 (5,208 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:28.415Z","embedding":null,"createdAt":"2026-04-18T20:25:54.722Z","updatedAt":"2026-05-18T18:52:28.415Z","lastSeenAt":"2026-05-18T18:52:28.415Z","tsv":"'/plugin':129,133 '1':123,240 '2':142,253,440 '3':165,270,441 '365':19,44,173 '4':282 '5':299 '6':312 'accept':208,215,340,342 'accept-eula':214,339 'access':122,556 'action':244,391,479,512,630,653 'add':131 'addit':297,659 'admin':174,180,184,579 'administr':190 'afternoon':434 'agenda':243,384,510,543 'agent':381 'agent/workflow':552 'alpha':120 'analysi':669 'anoth':551 'answer':286 'approv':186 'ask':274,347,351,353,363,540,594 'attende':521 'avail':207 'avoid':306 'best':494 'beyond':75 'binari':205 'block':317,431,483,633 'blocker':420,447 'browser':235,624 'budget':90 'c':614 'calendar':389 'call':443 'came':421 'cancel':603 'captur':652 'channel':112 'checklist':196 'clarifi':241 'clear':481 'cli':7,125,141,144,559,619 'cli/mcp':14 'combin':507 'command':200,272,324,326,531,577,601,606 'common':226 'communic':409 'complet':230,584,626 'concis':439 'confidenti':524 'confirm':217 'conflict':511,544 'conflicts/tasks':305 'consent':167,175 'consent/auth':572 'contact':182 'context':29 'continu':466 'contoso':406 'copilot':3,6,20,34,41,124,128,137,140,618 'copilot-plugin':136 'core':238 'correct':219 'craft':254 'ctrl':613 'custom':400 'data':21,45,80,597 'day/project/person':600 'deadlin':417 'deeper':321,492,668 'default':225 'desir':281 'devic':231,585 'differ':223 'direct':554 'display':335 'doc':24 'document':52,99,102,246,402 'draft':319,639 'e.g':262,467 'email':22,55,83,85 'enabl':191 'eng':267 'engin':111 'ensur':203,564,623 'error':573 'etc':252,323 'eula':176,210,216,341 'exampl':611 'execut':284 'explicit':527 'expos':160,376,520 'find':100 'finish':294 'first':168,344 'flight':195 'focus':430 'focus/overflow':634 'follow':58,315,395,487,628 'follow-up':57,314,394,486,627 'futur':535 'fy26':407 'g':149 'generic':455 'get':121,199 'get-command':198 'github/copilot-plugins':132 'global':331 'grant':580 'guid':4,192 'guidanc':644 'guidelin':436 'hang':602 'help':329 'highlight':302 'hold':635 'includ':257 'insight':303,418 'instal':134,148,336,560 'intellig':74 'intent':242 'interact':348 'issu':296 'item':245,392,513,654 'keep':437 'languag':48 'last':425 'let':40 'licens':343 'link':309,461 'list':403,522 'live':28,72 'load':445 'local':77 'log':529 'logic':509 'login':232,586,625 'long':285 'long/incomplete':587 'lookup':247 'manag':413 'map':475 'marketplac':130 'may':287 'mcp':145,155,158,161,371,373,546,549 'meet':23,91,96,427 'meetings/documents':454 'mention':462 'messag':54,108,641 'microsoft':18,43,172 'microsoft/workiq':150,154 'miss':558 'mode':349,547 'monitor':283 'multipl':503 'must':181 'narrow':497 'natur':47 'need':71,164,460,474,506,553 'next':450 'nois':501 'non':179 'non-admin':178 'note':304,320 'notifi':568 'npm':147,562 'npx':152 'offer':313,482,632 'option':332,449 'organiz':73 'output':508,588 'overlap':650 'overview':36 'past':307 'path':565 'pattern':383 'peopl':26,248 'people/projects':114 'per':187,599 'permiss':177,581 'plan':105,428 'plugin':126,138 'post':265 'powerpoint':404 'practic':495 'pre':194 'pre-flight':193 'precis':255 'prefer':127,361,496 'preview':39 'prioriti':446 'privaci':517 'project':119,663 'prompt':82,170,237,256,382,498 'public':38 'purpos':327 'q':277,358,365 'q4':104 'queri':17,42,322,493,504,661 'question':275,352,356 'rang':666 'raw':308 're':575 're-run':574 'readi':228 'recent':101 'recommend':32 'record':490,646 'redact':301 'reduc':500 'refer':325,452,538 'referenc':642 'refin':591 'repositori':78 'request':298,489,528,645 'requir':311 'rerun':589 'reschedule/decline':640 'respect':516 'respond':515 'respons':292,435 'restart':139,616 'retri':622 'risk':250 'roadmap':408 'run':156,197,271,491,502,533,576,605,658 'sampl':81 'sarah':87 'say':414 'schedul':51 'scope':592 'search':249 'send':485 'sentenc':442 'server':15,146,375 'session':620,651 'set':567 'shorthand':279,359 'show':330,470 'skill':35,67 'skill-workiq-copilot' 'slice':598 'snippet':525 'sourc':259 'source-github' 'specif':355,368,459,596 'stakehold':61,664 'standalon':143 'start':372 'stdio':374 'step':451,536 'stream':288 'suggest':429,478,637 'summar':84,107,263,300,393 'summari':30,62,251,438,648 'sun':472 'support':50,79 'sync':401 'target':366 'task':70,656 'team':25,53,106,264 'tenant':166,183,189,220,369 'termin':609 'thread':56 'three':426 'thu':471 'time':318,484,638,665 'timefram':258 'today':113,269,398 'tomorrow':390 'tool':162,378,555 'topic':261 'topic-agent-skills' 'topic-agents' 'topic-awesome' 'topic-custom-agents' 'topic-github-copilot' 'topic-hacktoberfest' 'topic-prompt-engineering' 'track':60 'tracker':657 'troubleshoot':557 'tuesday':433 'unavail':571 'unless':310,456,526 'up':316,396 'upcom':95 'use':11,65,169,276,345,357,545 'user':458,569 'version':334,337 'via':212,561 'wait':289 'week':98 'whenev':68 'work':117 'workflow':239 'workiq':2,13,33,37,135,157,201,213,273,328,333,338,346,350,362,370,377,464,468,476,541,548,643,660 'workiq-copilot':1 'y':153","prices":[{"id":"9d8e663b-393b-4429-acc9-9c7768a454d3","listingId":"5779fc04-682a-4302-982e-4d1d32c085fc","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:25:54.722Z"}],"sources":[{"listingId":"5779fc04-682a-4302-982e-4d1d32c085fc","source":"github","sourceId":"github/awesome-copilot/workiq-copilot","sourceUrl":"https://github.com/github/awesome-copilot/tree/main/skills/workiq-copilot","isPrimary":false,"firstSeenAt":"2026-04-18T21:51:41.899Z","lastSeenAt":"2026-05-18T18:52:28.415Z"},{"listingId":"5779fc04-682a-4302-982e-4d1d32c085fc","source":"skills_sh","sourceId":"github/awesome-copilot/workiq-copilot","sourceUrl":"https://skills.sh/github/awesome-copilot/workiq-copilot","isPrimary":true,"firstSeenAt":"2026-04-18T20:25:54.722Z","lastSeenAt":"2026-05-07T22:40:18.369Z"}],"details":{"listingId":"5779fc04-682a-4302-982e-4d1d32c085fc","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"github","slug":"workiq-copilot","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":"2536e569c7b6494e6efc8c28c69a7f02bc090c97","skill_md_path":"skills/workiq-copilot/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/github/awesome-copilot/tree/main/skills/workiq-copilot"},"layout":"multi","source":"github","category":"awesome-copilot","frontmatter":{"name":"workiq-copilot","description":"Guides the Copilot CLI on how to use the WorkIQ CLI/MCP server to query Microsoft 365 Copilot data (emails, meetings, docs, Teams, people) for live context, summaries, and recommendations."},"skills_sh_url":"https://skills.sh/github/awesome-copilot/workiq-copilot"},"updatedAt":"2026-05-18T18:52:28.415Z"}}