Workiq Copilot
github/awesome-copilot
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.
Builds, tests, and deploys Microsoft 365 apps and agents for Teams and Copilot.
Install Microsoft 365 Agents Toolkit
$ npx skills add OfficeDev/microsoft-365-agents-toolkit --skill microsoft-365-agents-toolkit -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install OfficeDev/microsoft-365-agents-toolkit microsoft-365-agents-toolkit --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/OfficeDev/microsoft-365-agents-toolkit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/vscode-extension/skills/microsoft-365-agents-toolkit .claude/skills/microsoft-365-agents-toolkit && rm -rf skills-srcUse ~/.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/
Install the "microsoft-365-agents-toolkit" agent skill from https://github.com/OfficeDev/microsoft-365-agents-toolkit/tree/dev/packages/vscode-extension/skills/microsoft-365-agents-toolkit into .claude/skills/microsoft-365-agents-toolkit/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "microsoft-365-agents-toolkit", 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 install https://github.com/OfficeDev/microsoft-365-agents-toolkit/tree/dev/packages/vscode-extension/skills/microsoft-365-agents-toolkitType 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.
$ npx skills add OfficeDev/microsoft-365-agents-toolkit --skill microsoft-365-agents-toolkit -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install OfficeDev/microsoft-365-agents-toolkit microsoft-365-agents-toolkit --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/OfficeDev/microsoft-365-agents-toolkit.git skills-src && mkdir -p .agents/skills && cp -r skills-src/packages/vscode-extension/skills/microsoft-365-agents-toolkit .agents/skills/microsoft-365-agents-toolkit && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "microsoft-365-agents-toolkit" agent skill from https://github.com/OfficeDev/microsoft-365-agents-toolkit/tree/dev/packages/vscode-extension/skills/microsoft-365-agents-toolkit into .agents/skills/microsoft-365-agents-toolkit/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "microsoft-365-agents-toolkit", 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.
$ npx skills add OfficeDev/microsoft-365-agents-toolkit --skill microsoft-365-agents-toolkit -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install OfficeDev/microsoft-365-agents-toolkit microsoft-365-agents-toolkit --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/OfficeDev/microsoft-365-agents-toolkit.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/packages/vscode-extension/skills/microsoft-365-agents-toolkit .cursor/skills/microsoft-365-agents-toolkit && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "microsoft-365-agents-toolkit" agent skill from https://github.com/OfficeDev/microsoft-365-agents-toolkit/tree/dev/packages/vscode-extension/skills/microsoft-365-agents-toolkit into .cursor/skills/microsoft-365-agents-toolkit/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "microsoft-365-agents-toolkit", 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 https://github.com/OfficeDev/microsoft-365-agents-toolkit.git --path packages/vscode-extension/skills/microsoft-365-agents-toolkit--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add OfficeDev/microsoft-365-agents-toolkit --skill microsoft-365-agents-toolkit -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install OfficeDev/microsoft-365-agents-toolkit microsoft-365-agents-toolkit --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/OfficeDev/microsoft-365-agents-toolkit.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/packages/vscode-extension/skills/microsoft-365-agents-toolkit .gemini/skills/microsoft-365-agents-toolkit && rm -rf skills-srcUse ~/.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/
Install the "microsoft-365-agents-toolkit" agent skill from https://github.com/OfficeDev/microsoft-365-agents-toolkit/tree/dev/packages/vscode-extension/skills/microsoft-365-agents-toolkit into .gemini/skills/microsoft-365-agents-toolkit/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "microsoft-365-agents-toolkit", 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.
$ gh skill install OfficeDev/microsoft-365-agents-toolkit microsoft-365-agents-toolkitInstalls 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).
$ npx skills add OfficeDev/microsoft-365-agents-toolkit --skill microsoft-365-agents-toolkit -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/OfficeDev/microsoft-365-agents-toolkit.git skills-src && mkdir -p .github/skills && cp -r skills-src/packages/vscode-extension/skills/microsoft-365-agents-toolkit .github/skills/microsoft-365-agents-toolkit && rm -rf skills-srcUse ~/.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/
Install the "microsoft-365-agents-toolkit" agent skill from https://github.com/OfficeDev/microsoft-365-agents-toolkit/tree/dev/packages/vscode-extension/skills/microsoft-365-agents-toolkit into .github/skills/microsoft-365-agents-toolkit/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "microsoft-365-agents-toolkit", 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.
$ npx skills add OfficeDev/microsoft-365-agents-toolkit --skill microsoft-365-agents-toolkit -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install OfficeDev/microsoft-365-agents-toolkit microsoft-365-agents-toolkit --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/OfficeDev/microsoft-365-agents-toolkit.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/packages/vscode-extension/skills/microsoft-365-agents-toolkit .opencode/skills/microsoft-365-agents-toolkit && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "microsoft-365-agents-toolkit" agent skill from https://github.com/OfficeDev/microsoft-365-agents-toolkit/tree/dev/packages/vscode-extension/skills/microsoft-365-agents-toolkit into .opencode/skills/microsoft-365-agents-toolkit/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "microsoft-365-agents-toolkit", 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
microsoft-365-agents-toolkit- GitHub stars
- 780
- Token cost
- ~2.8k tokens
- SKILL.md length
- 1,044 words
- Files
- 159
- Skills in repo
- 7
- Repo updated
- First seen
- Licence
- Custom licence
At a glance
Builds, tests, and deploys Microsoft 365 apps and agents for Teams and Copilot.
- Works in 3 steps: Detect ATK Project → Resolve Common Configuration → Collect Missing Values
- : Declarative Agents
- SKILL.md covers Declarative Agent Routing, AI Behavior Guidelines, ATK CLI Setup and CLI Global Options, plus 4 more sections
- Calls npm and python; needs AZURE_OPENAI_API_KEY
What it does
Microsoft 365 Agents Toolkit is an agent skill from OfficeDev/microsoft-365-agents-toolkit. Builds, tests, and deploys Microsoft 365 apps and agents for Teams and Copilot. Uses WIQD for pure Declarative Agents and DAs backed by existing APIs, MCP servers, or Copilot Connector connections; uses ATK for Declarative Agents with project-owned backend code and deployment and for TypeSpec DA projects. Uses ATK for Custom Engine Agents, Teams bots, tabs, message extensions, Agents Playground, and Teams runtime testing. USE FOR: Declarative Agents, Custom Engine Agents, Teams apps, local testing, deployment…
Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 162 other files (for example `create-project/create-project.md`, `docs/README.md` and `docs/advanced-features.md`).
It sits in Documents & Office, covering Cloud office suites and MCP servers. It works with Microsoft 365, Model Context Protocol and Slack. The repository describes itself as: Developer tools for building Teams apps.
When your agent uses it
- : Declarative Agents
- Custom Engine Agents
- Troubleshooting
- Slack-to-Teams migration
Example prompts
- “/microsoft-365-agents-toolkit”
Requirements
- Python 3
- Node.js
- A credential in AZURE_OPENAI_API_KEY
Workflow steps
3 steps, taken from the step headings in SKILL.md.
- Detect ATK Project
- Resolve Common Configuration
- Collect Missing Values
What it can do on your machine
Read from SKILL.md and the folder at commit c89a0dd. 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
Shell commands in SKILL.md call:
npmpython
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
AZURE_OPENAI_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Microsoft 365 Agents Toolkit loads about 2.8k tokens when it runs. Until then it costs about 166 tokens; SKILL.md has 1,044 words of instructions outside code blocks.
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: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
- NoteMentions a .env fileSKILL.md:33
ead error messages carefully. Check `env/.env.local`, `.localConfigs`, and `atk auth list`. Common pitfalls:
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 1,044 words (~2,820 tokens).
“Build pure Declarative Agents and DAs that use existing APIs, MCP servers, or Copilot Connector connections with WIQD. Use ATK for DAs that own and deploy backend compute, including projects that build and deploy a new Copilot Connector backend, TypeSpec…”
- name
- microsoft-365-agents-toolkit
Files
SKILL.md and 158 other files in packages/vscode-extension/skills/microsoft-365-agents-toolkit of OfficeDev/microsoft-365-agents-toolkit.
- SKILL.md
- create-project/create-project.md
- docs/README.md
- docs/advanced-features.md
- docs/feature-gaps.md
- docs/files-and-links.md
- docs/identity-and-auth.md
- docs/infrastructure.md
- docs/interactive-responses.md
- docs/messaging-and-commands.md
- docs/middleware-and-handlers.md
- docs/ui-components.md
- docs/workflows.md
- experts/README.md
- experts/_expert-ts.md
- experts/analyzer.md
- experts/bridge/app-distribution-packaging-ts.md
- … and 142 more
Open the folder on GitHubat commit c89a0dd
Compare with similar skills
Microsoft 365 Agents Toolkit 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Microsoft 365 Agents Toolkit this skillOfficeDev/microsoft-365-agents-toolkit | 780 | — | ~2.8k | Automated safety check: Notes | Custom licence | |
| Workiq Copilotgithub/awesome-copilot | 40k | 1 repos | ~1.4k | Automated safety check: Pass | MIT | |
| Managing Google Workspacetaylorwilsdon/google_workspace_mcp | 3.3k | — | ~2.9k | Automated safety check: Pass | MIT | |
| Gdoc To Markdowniurykrieger/claude-bedrock | 105 | 1 repos | ~3.8k | Automated safety check: Notes | MIT | |
| Workiqmicrosoft/work-iq | 1k | — | ~15k | Automated safety check: Pass | Custom licence | |
| AI Agent PostureSCStelz/security-investigator | 249 | — | ~21k | Automated safety check: Pass | MIT |
Similar skills
- Official
Managing Google Workspace
taylorwilsdon/google_workspace_mcp
Manages Google Workspace operations across 12 services (Gmail, Drive, Calendar, Docs, Sheets, Slides, Forms, Tasks, Contacts, Chat, Apps Script, Custom Search).
Gdoc To Markdown
iurykrieger/claude-bedrock
Internal fetcher module for Google Docs and Sheets. An agent skill from iurykrieger/claude-bedrock.
- Official
Workiq
microsoft/work-iq
WorkIQ tools for Microsoft 365 workplace data and actions. An agent skill from microsoft/work-iq.
AI Agent Posture
SCStelz/security-investigator
Audit or report on AI agent security posture across Copilot Studio, Microsoft 365 Copilot, Microsoft Foundry, and third-party agents.
- Official
Teams App Developer
microsoft/skills
Builds, tests, and deploys Microsoft 365 apps and agents for Teams and Copilot.
More from OfficeDev/microsoft-365-agents-toolkit
Component Governance Remediation
OfficeDev/microsoft-365-agents-toolkit
A skill your agent uses when: retrieving, exporting, triaging, or remediating Azure DevOps Component Governance alerts for this repository, including CG report URLs, vulnerable pnpm dependencies…
Vscuse Case Diagnosis
OfficeDev/microsoft-365-agents-toolkit
A skill your agent uses when: running an existing vscuse test case, reproducing a failing vscuse plan, deciding product bug vs test plan drift vs setup failure vs flake, repairing a failing case…
Vscuse Scenario Authoring
OfficeDev/microsoft-365-agents-toolkit
A skill your agent uses when: reading a docs scenario, PRD, mockup, or user flow and using vscuse-ui/noVNC as the primary authoring surface to record, generate, replace, or update vscuse test plans…
Prd UX Design
OfficeDev/microsoft-365-agents-toolkit
A skill your agent uses when adding or changing product requirements, scenarios, user flows, surface behavior, or design artifacts before specs or implementation.
Vibe Coding
OfficeDev/microsoft-365-agents-toolkit
End-to-end workflow for agent-driven changes that add or modify behavior in the toolkit packages.
Local Vscuse Validation
OfficeDev/microsoft-365-agents-toolkit
A skill your agent uses when: setting up shared local vscuse prerequisites, credentials, runner, local or pinned published Docker images, local VSIX, env variables, and common rules for Microsoft…
Related
Works with
Categories
Questions about Microsoft 365 Agents Toolkit
What does Microsoft 365 Agents Toolkit do?
Builds, tests, and deploys Microsoft 365 apps and agents for Teams and Copilot. Microsoft 365 Agents Toolkit is an agent skill from OfficeDev/microsoft-365-agents-toolkit. Builds, tests, and deploys Microsoft 365 apps and agents for Teams and Copilot.
When should I use Microsoft 365 Agents Toolkit?
Microsoft 365 Agents Toolkit fits situations like: : Declarative Agents; custom Engine Agents; troubleshooting; slack-to-Teams migration.
How do I install Microsoft 365 Agents Toolkit in Claude Code?
Run `npx skills add OfficeDev/microsoft-365-agents-toolkit --skill microsoft-365-agents-toolkit -a claude-code`. Or copy the skill folder (packages/vscode-extension/skills/microsoft-365-agents-toolkit in OfficeDev/microsoft-365-agents-toolkit) into .claude/skills/microsoft-365-agents-toolkit in your project. Claude Code loads it when a task matches its description.
How do I install Microsoft 365 Agents Toolkit in Codex?
Run `npx skills add OfficeDev/microsoft-365-agents-toolkit --skill microsoft-365-agents-toolkit -a codex`. Or copy the skill folder (packages/vscode-extension/skills/microsoft-365-agents-toolkit in OfficeDev/microsoft-365-agents-toolkit) into .agents/skills/microsoft-365-agents-toolkit in your project. Codex loads it when a task matches its description.
Can I use Microsoft 365 Agents Toolkit 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 OfficeDev/microsoft-365-agents-toolkit --skill microsoft-365-agents-toolkit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/microsoft-365-agents-toolkit, .gemini/skills/microsoft-365-agents-toolkit, .github/skills/microsoft-365-agents-toolkit and .opencode/skills/microsoft-365-agents-toolkit in your project.
What does Microsoft 365 Agents Toolkit need to run?
Going by SKILL.md and its folder, Microsoft 365 Agents Toolkit needs the command-line tools its instructions call (npm and python) and credentials named AZURE_OPENAI_API_KEY. Our summary lists: Python 3; Node.js; A credential in AZURE_OPENAI_API_KEY.
Does Microsoft 365 Agents Toolkit access the network?
SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Microsoft 365 Agents Toolkit safe to install?
Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.
What licence does Microsoft 365 Agents Toolkit use?
Microsoft 365 Agents Toolkit 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 Microsoft 365 Agents Toolkit use?
About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Microsoft 365 Agents Toolkit?
Skills that share tags, products or a category with Microsoft 365 Agents Toolkit: Workiq Copilot (github/awesome-copilot, 40k stars), Managing Google Workspace (taylorwilsdon/google_workspace_mcp, 3.3k stars), Gdoc To Markdown (iurykrieger/claude-bedrock, 105 stars) and Workiq (microsoft/work-iq, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Microsoft 365 Agents Toolkit?
OfficeDev (a GitHub organization) maintains it in OfficeDev/microsoft-365-agents-toolkit, which has 780 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 10, 2026.
Source: OfficeDev/microsoft-365-agents-toolkit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.