Official agent skill

Workiq

WorkIQ tools for Microsoft 365 workplace data and actions. An agent skill from microsoft/work-iq.

OfficialCustom licenceAuto-check passedDocuments & Office

Install Workiq

skills CLI

$ npx skills add microsoft/work-iq --skill workiq -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install microsoft/work-iq workiq --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/microsoft/work-iq.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/workiq/skills/workiq .claude/skills/workiq && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "workiq" agent skill from https://github.com/microsoft/work-iq/tree/main/plugins/workiq/skills/workiq into .claude/skills/workiq/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "workiq", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/microsoft/work-iq/tree/main/plugins/workiq/skills/workiq

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add microsoft/work-iq --skill workiq -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install microsoft/work-iq workiq --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/microsoft/work-iq.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/workiq/skills/workiq .agents/skills/workiq && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "workiq" agent skill from https://github.com/microsoft/work-iq/tree/main/plugins/workiq/skills/workiq into .agents/skills/workiq/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "workiq", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add microsoft/work-iq --skill workiq -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install microsoft/work-iq workiq --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/microsoft/work-iq.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/workiq/skills/workiq .cursor/skills/workiq && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "workiq" agent skill from https://github.com/microsoft/work-iq/tree/main/plugins/workiq/skills/workiq into .cursor/skills/workiq/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "workiq", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/microsoft/work-iq.git --path plugins/workiq/skills/workiq

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add microsoft/work-iq --skill workiq -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install microsoft/work-iq workiq --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/microsoft/work-iq.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/workiq/skills/workiq .gemini/skills/workiq && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "workiq" agent skill from https://github.com/microsoft/work-iq/tree/main/plugins/workiq/skills/workiq into .gemini/skills/workiq/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "workiq", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install microsoft/work-iq workiq

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add microsoft/work-iq --skill workiq -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/microsoft/work-iq.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/workiq/skills/workiq .github/skills/workiq && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "workiq" agent skill from https://github.com/microsoft/work-iq/tree/main/plugins/workiq/skills/workiq into .github/skills/workiq/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "workiq", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add microsoft/work-iq --skill workiq -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install microsoft/work-iq workiq --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/microsoft/work-iq.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/workiq/skills/workiq .opencode/skills/workiq && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "workiq" agent skill from https://github.com/microsoft/work-iq/tree/main/plugins/workiq/skills/workiq into .opencode/skills/workiq/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "workiq", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: workiq
GitHub stars: 1k
Token cost: ~15k tokens
SKILL.md length: 7,157 words
Files: 19 (incl. references)
Skills in repo: 18
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: Custom licence

At a glance

WorkIQ tools for Microsoft 365 workplace data and actions. An agent skill from microsoft/work-iq.

Works in 4 steps: Path discovery ("endpoint", "available… → Schema inspection ("schema", "data… → Exact entity read or mutation by… → …
Calendar events and meetings
SKILL.md covers 🛑 STOP — Read This Before…, CRITICAL: When to Use This Skill, Prerequisites and Configuration, plus 3 more sections
Reaches workiq.svc.cloud.microsoft and graph.microsoft.com

What it does

Workiq is an agent skill from microsoft/work-iq, published by the product's own GitHub organization. WorkIQ tools for Microsoft 365 workplace data and actions. Use for email, calendar events and meetings, files, SharePoint, OneDrive, Teams, people, Planner, and other M365 requests. Triggers include cancel meeting or event, accept or decline meetings, create or update events, create an upload session or replace an existing OneDrive file, find or summarize workplace content, send or reply to mail, manage or download files, manage tasks, read SharePoint library metadata or columns, filter/count/group/sort files by…

Its SKILL.md is about 15k tokens, which your agent loads only when the skill is triggered. The skill folder holds 19 other files, including reference files (for example `references/ask-work-iq.md`, `references/business-applications.md` and `references/call-function-work-iq.md`). Compatibility notes: Uses the hosted WorkIQ MCP endpoint. No local package is required for MCP tool calls.

It sits in Documents & Office, covering Cloud office suites. It works with Microsoft 365, Microsoft SharePoint, Microsoft OneDrive and Model Context Protocol. The repository describes itself as: MCP Server and CLI for accessing Work IQ.

When your agent uses it

Calendar events and meetings
Other M365 requests
Include cancel meeting
Decline meetings

Example prompts

“/workiq”

Requirements

Compatibility (from SKILL.md): Uses the hosted WorkIQ MCP endpoint. No local package is required for MCP tool calls.

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

Path discovery ("endpoint", "available operations", "what can I do with X") → search_paths first. Continue to the read/write tool if the…
Schema inspection ("schema", "data model", "fields", "what does X take") → get_schema first. With operationType: "action", it returns the…
Exact entity read or mutation by title/name/channel/thread → fetch to resolve the target's ID, then update_entity / delete_entity /…
Semantic summary/status/decisions → ask. If the prompt then asks to draft, send, create, update, delete, forward, or react, continue with…

What it can do on your machine

Read from SKILL.md and the folder at commit 1060873. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are json).
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- workiq.svc.cloud.microsoft
- graph.microsoft.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Compatibility
Uses the hosted WorkIQ MCP endpoint. No local package is required for MCP tool calls.
From compatibility in the SKILL.md frontmatter.

Context cost

Workiq loads about 15k tokens when it runs, and up to ~45k if it reads all its reference files. Until then it costs about 208 tokens; SKILL.md has 7,157 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~208
When it runs · the whole SKILL.md, loaded when a task matches: ~15k
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~45k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 7,157 words (~14,716 tokens).

“WorkIQ connects AI agents to Microsoft 365 Copilot for workplace intelligence grounded in organizational data. This skill teaches the model how to use the full WorkIQ toolset: the agentic ask tool for semantic questions and the fast entity tools for…”

— opening of SKILL.md by microsoft, Custom licence

name: workiq
compatibility: Uses the hosted WorkIQ MCP endpoint. No local package is required for MCP tool calls.

Outline of SKILL.md

WorkIQ
🛑 STOP — Read This Before Your First Tool Call
CRITICAL: When to Use This Skill
Required workflow order — don't stop after a preparatory lookup
Resolve-then-act — concrete examples
Grounding rules
Don't substitute web search or CLI introspection
Prerequisites
Configuration
Authentication before hosted MCP calls
Resolving tool names in your host
MCP Tools
ask — Agentic natural language M365 queries
Entity Tools
🛑 SharePoint document-library metadata
🗺️ Known paths — go direct, skip discovery
🗂️ Reaching a SharePoint or OneDrive file — the working sequence
Binary downloads use fetch_blob; upload_blob is not released
⚠️ Directory users and personal contacts are different stores
🛑 Schema/discovery questions stay on MCP — never web_fetch or CLI introspection
Efficiency rules — minimize tool calls
Missing information — use fetch to disambiguate, don't give up
🔁 Resolve-then-act — do not loop searches
⚠️ URL Format Rules (ALL entity tools)
jsonBody Format Rules (write tools)
⚠️ Placeholders in examples are not literals
⚠️ Write actions execute immediately — confirm with the user first
"Draft", "compose", "prepare reply" requires a persisted draft
Schema for action verbs
Entity tool reference

Read the full SKILL.md on GitHub

Files

SKILL.md and 18 other files (references) in plugins/workiq/skills/workiq of microsoft/work-iq.

SKILL.md
references/ask-work-iq.md
references/business-applications.md
references/call-function-work-iq.md
references/create-entity-work-iq.md
references/delete-entity-work-iq.md
references/do-action-work-iq.md
references/fetch-blob-work-iq.md
references/fetch-work-iq.md
references/get-schema-work-iq.md
references/mail-work-iq.md
references/search-paths-work-iq.md
references/sharepoint-library-metadata.md
references/sharepoint-work-iq.md
references/tasks-work-iq.md
references/teams-work-iq.md
references/troubleshooting.md
references/update-entity-work-iq.md
references/upload-blob-work-iq.md

Open the folder on GitHubat commit 1060873

Compare with similar skills

Workiq next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Workiq compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Workiq this skillmicrosoft/work-iq	1k	—	~15k	Automated safety check: Pass	Custom licence	today
Msgraph Filesautomateyournetwork/netclaw	674	—	~1k	Automated safety check: Pass	Apache-2.0	2 days ago
Msgraph Visioautomateyournetwork/netclaw	674	—	~1k	Automated safety check: Pass	Apache-2.0	2 days ago
Add Workiqmicrosoft/power-platform-skills	967	—	~5.6k	Automated safety check: Notes	MIT	today
Msgraphcodemie-ai/codemie-code	294	—	~4.1k	Automated safety check: Pass	Apache-2.0	yesterday
aai-cli Microsoft 365aai-labs/agent-barn	109	—	~1.2k	Automated safety check: Pass	Apache-2.0	yesterday

Similar skills

Msgraph Files
automateyournetwork/netclaw
Read OneDrive and SharePoint files via the Microsoft 365 MCP server — list folder contents, fetch item metadata, inspect versions and sharing permissions.
674 GitHub stars~1k tokensUpdated 2 days ago
Documents & OfficeAuto-check passed
Msgraph Visio
automateyournetwork/netclaw
Upload and retrieve Visio (.vsdx) and other diagram files in OneDrive/SharePoint via the Microsoft 365 MCP server.
674 GitHub stars~1k tokensUpdated 2 days ago
Documents & OfficeAuto-check passed
Add Workiq
microsoft/power-platform-skills
Official
Adds Work IQ (M365 Copilot Search) to a Power Apps code app via the Work IQ Copilot MCP connector (shareda365copilotchatmcp), then wires up a production-ready McpSession wrapper for AI-powered…
967 GitHub stars~5.6k tokensUpdated today
Documents & OfficeAuto-check: notes
Msgraph
codemie-ai/codemie-code
Work with Microsoft 365 services via the Graph API — emails, calendar events, SharePoint sites (read and write), Teams chats and channel messages, OneDrive files, OneNote notebooks, Planner task…
294 GitHub stars~4.1k tokensUpdated yesterday
Documents & OfficeAuto-check passed
aai-cli Microsoft 365
aai-labs/agent-barn
Guides work with Outlook, OneDrive, SharePoint, Teams, Excel, To Do and Planner through aai-cli's Microsoft Graph commands, starting from which service owns the data.
109 GitHub stars~1.2k tokensUpdated yesterday
Documents & OfficeAuto-check passed
Microsoft 365
HybridAIOne/hybridclaw
Read Microsoft 365 data through Microsoft Graph: Outlook mail/calendar, OneDrive/SharePoint files, Teams, chats, and user profile.
158 GitHub stars~1.4k tokensUpdated yesterday
Documents & OfficeAuto-check passed

Questions about Workiq

What does Workiq do?

WorkIQ tools for Microsoft 365 workplace data and actions. An agent skill from microsoft/work-iq. Workiq is an agent skill from microsoft/work-iq, published by the product's own GitHub organization. WorkIQ tools for Microsoft 365 workplace data and actions.

When should I use Workiq?

Workiq fits situations like: calendar events and meetings; other M365 requests; include cancel meeting; decline meetings.

How do I install Workiq in Claude Code?

Run `npx skills add microsoft/work-iq --skill workiq -a claude-code`. Or copy the skill folder (plugins/workiq/skills/workiq in microsoft/work-iq) into .claude/skills/workiq in your project. Claude Code loads it when a task matches its description.

How do I install Workiq in Codex?

Run `npx skills add microsoft/work-iq --skill workiq -a codex`. Or copy the skill folder (plugins/workiq/skills/workiq in microsoft/work-iq) into .agents/skills/workiq in your project. Codex loads it when a task matches its description.

Can I use Workiq in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add microsoft/work-iq --skill workiq -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/workiq, .gemini/skills/workiq, .github/skills/workiq and .opencode/skills/workiq in your project.

What does Workiq need to run?

SKILL.md names no scripts, command-line tools or credentials: Workiq is instructions for the agent only. Compatibility (from SKILL.md): Uses the hosted WorkIQ MCP endpoint. No local package is required for MCP tool calls. .

Does Workiq access the network?

SKILL.md names 2 domains. In commands or code: workiq.svc.cloud.microsoft and graph.microsoft.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Workiq safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Workiq use?

Workiq has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Workiq use?

About 15k tokens (SKILL.md is roughly 59k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 31k tokens, read only when the agent opens those files.

What are the alternatives to Workiq?

Skills that share tags, products or a category with Workiq: Msgraph Files (automateyournetwork/netclaw, 674 stars), Msgraph Visio (automateyournetwork/netclaw, 674 stars), Add Workiq (microsoft/power-platform-skills, 967 stars) and Msgraph (codemie-ai/codemie-code, 294 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Workiq?

microsoft (a GitHub organization, an official publisher) maintains it in microsoft/work-iq, which has 1,027 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 7, 2026.

Source: microsoft/work-iq on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Workiq

Install Workiq

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Compatibility

Context cost

Safety

SKILL.md

Files

Compare with similar skills

Similar skills

Msgraph Files

Msgraph Visio

Add Workiq

Msgraph

aai-cli Microsoft 365

Microsoft 365

More from microsoft/work-iq

Declarative Agent Developer

M365 Agent Evaluator

Install Atk

Teams App Developer

UI Widget Developer

Slack To Teams

Questions about Workiq

Install Workiq

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Compatibility

Context cost

Safety

SKILL.md

Files

Compare with similar skills

Similar skills

More from microsoft/work-iq

Related

Questions about Workiq