workiq-copilot Skill (awesome-copilot) for GitHub Copilot CLI: What It Does and How to Install It

Teaches GitHub Copilot CLI to query your Microsoft 365 emails, meetings, documents and Teams messages with the WorkIQ CLI.

Installs: 8.8K; on skills.sh
Stars: 40.7K; on GitHub
Updated: Oct 2026; last repo commit

This skill teaches Copilot CLI to use WorkIQ, a Microsoft 365 tool that answers questions about your emails, meetings, documents, Teams messages and colleagues. Claude runs workiq ask with a precise question, then summarizes the answer in two or three sentences and offers follow-ups such as blocking focus time.

The folder has one file, SKILL.md, and no scripts. Before it works you need the WorkIQ CLI or plugin, a license acceptance and Microsoft 365 admin consent for your tenant. SKILL.md calls WorkIQ a Public Preview.

Good for

Copilot CLI users who need live context from work email and meetings
Anyone asking for a schedule, follow-ups or focus-time suggestions
People who look up who is working on a project

Install workiq-copilot

Copilot CLI

Copy this prompt.

Install the workiq-copilot skill in Copilot CLI. Run this command:

/plugin marketplace add github/copilot-plugins
/plugin install workiq@copilot-plugins

Then check that it loaded and tell me how to use it.

2
Paste it into Copilot CLI. It shows the change and asks before running it.

Pick one route to get WorkIQ itself: the Copilot CLI plugin (marked preferred in SKILL.md) or the npm CLI. SKILL.md also lists npx -y @microsoft/workiq mcp. First use asks for Microsoft 365 admin consent, and non-admins must ask their tenant admin. Restart Copilot CLI after the plugin install. The skills CLI command installs this skill only.

From the vendor's docs. Source.

What's in the skill

When it loads

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.

Sections in SKILL.md

Overview
Supported Data & Sample Prompts
Getting Access
Pre-flight Checklist
Core Workflow
Command Reference
Prompt Patterns
Response Guidelines
Best Practices
Troubleshooting
Follow-up Actions to Offer

Key facts

Author: (awesome-copilot); no author is named for this skill, and the repo LICENSE reads "Copyright GitHub, Inc."
License: MIT (repo LICENSE)
Installs on skills.sh: 8,838 (Nov 2, 2026)
GitHub stars: 40,666 for the whole github/awesome-copilot repo (Nov 2, 2026)
Last repo commit: Oct 30, 2026
Audits on skills.sh: Gen Agent Trust Hub: pass, Socket: pass, Snyk: warn
What it includes: 1 file: SKILL.md (no scripts)
Needs: WorkIQ CLI or plugin, EULA acceptance, Microsoft 365 admin consent
Works in: GitHub Copilot CLI (the skill says it guides the Copilot CLI)

What it includes

Copilot CLI plugin, or npm install -g @microsoft/workiq, plus tenant consent
The plugin route is marked preferred. First use asks for Microsoft 365 admin consent (EULA and permissions).
Runs code · Getting access
Get-Command workiq, workiq accept-eula, tenant, browser device login
Checks the binary exists, accepts the license once, picks the tenant and expects a device login in the browser.
Runs code · Pre-flight checklist
workiq ask --question "<prompt>" (or -q), optionally -t <tenant>
Queries emails, meetings, documents, Teams messages and people data in natural language.
Try: “Summarize emails from Sarah about the budget”
Runs code · Ask WorkIQ
workiq mcp starts an MCP stdio server for other agents
Use it when another agent or workflow needs direct tool access.
Runs code · MCP mode
Short summaries, generic references, no attendee lists unless asked
Also: log which commands were run and offer follow-ups such as blocking time or drafting a decline.
Read · Response guidelines
Missing CLI, consent errors, long output, hanging commands
For a hang it says to cancel with Ctrl+C or restart the session and check the browser login finished.
Read · Troubleshooting

From the official docs

Permissions

Medium risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It reads sensitive work data
Emails, meetings, files and Teams messages can end up in the model's context. Ask narrow questions, as SKILL.md advises, and do not share the output beyond who may see it. github.com
Admin consent and a global install
SKILL.md has you install @microsoft/workiq with npm install -g, accept an EULA and get tenant admin consent for permissions. Ask your admin first if you are not one. github.com
workiq mcp exposes WorkIQ to other agents
workiq mcp starts an MCP stdio server so other agents get direct tool access to your Microsoft 365 data. Start it only for agents you trust. github.com
Browser device login
SKILL.md expects you to complete a device login in the browser when prompted. github.com

Technical details

Turning on read-only	No read-only mode.
Talks to	npm registry (@microsoft/workiq). Microsoft 365 through the WorkIQ CLI (SKILL.md names no hosts)
Sign-in and keys	Sign-in is a Microsoft device login in your browser. SKILL.md does not say where the session is kept.
Scopes	Queries your Microsoft 365 emails, meetings, documents, Teams messages and people data through WorkIQ Installs the WorkIQ CLI from npm, or a Copilot CLI plugin Needs Microsoft 365 admin consent for your tenant

Questions

What does the workiq-copilot skill do?

It tells Copilot CLI how to use the WorkIQ CLI to query your Microsoft 365 data in plain language. That covers emails, meetings, documents, Teams messages and people, for live context, summaries and recommendations.

Is WorkIQ from Microsoft?

The CLI the skill drives is the @microsoft/workiq npm package, and SKILL.md calls WorkIQ a Public Preview. The skill itself is listed in the github/awesome-copilot collection, which the README says is sourced from third-party developers.

What do I need before it works?

The WorkIQ CLI or plugin, acceptance of its license with workiq accept-eula, and Microsoft 365 admin consent for your tenant. Non-admins must ask their tenant admin to approve, per SKILL.md. You also sign in through a device login in the browser.

Which clients does it work in?

SKILL.md is written for the Copilot CLI. It also describes workiq mcp, which starts an MCP server so other agents can use WorkIQ tools.

How do I install it?

Use the install box at the top of this page. It has the skills CLI command for this skill and the WorkIQ setup steps from SKILL.md.

Is it safe?

It lets an AI assistant query your work email, meetings, files and Teams messages, so what comes back can be sensitive. SKILL.md says to keep summaries short, avoid attendee lists and confidential snippets unless asked, and not to paste raw links. It also installs an npm package and needs admin consent.

Information

updated Nov 2, 2026

Repository: github/awesome-copilot
Folder: skills/workiq-copilot

github/awesome-copilot skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 2

workiq-copilot SKILL.md · github.com
awesome-copilot README · github.com