install-atk

✓ Official★ 923

by microsoft · part of microsoft/work-iq

Install or update the M365 Agents Toolkit (ATK) CLI and/or VS Code extension.

🔥🔥✓ VerifiedFreeQuick setup

🧰 Not standalone. This skill ships with microsoft/work-iq and only works together with that tool — install the tool first, then add this skill.

This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.

name: install-atk description: > Install or update the M365 Agents Toolkit (ATK) CLI and VS Code extension. Triggers: "install atk", "update atk", "install agents toolkit", "update agents toolkit", "install the toolkit", "setup atk", "get atk", "install atk cli", "install atk extension", "install atk vsix", "update the vs code extension", "install latest atk", "upgrade atk"

Install ATK

Install or update the M365 Agents Toolkit (ATK) CLI and/or VS Code extension.

Telemetry Tagging

Before running any atk CLI commands, set the session environment variable so all CLI invocations are tagged as skill-initiated:

export ATK_CLI_SKILL=true

Run this once at the start of the session. All subsequent atk commands in the same terminal will inherit it.

Triggers

This skill activates when the user asks to:

Install or update ATK / Agents Toolkit / the toolkit
Install or update the ATK CLI
Install or update the ATK VS Code extension / VSIX
Set up ATK / get started with ATK

Behavior

ATK CLI commands use npx -y --package @microsoft/m365agentstoolkit-cli atk which automatically downloads and runs the latest version — no global installation is needed.

When triggered, determine what the user wants:

User intent	Action
Install/update everything or just "ATK"	Verify CLI works + install VSIX
Install/update CLI only	Verify CLI works (npx handles it automatically)
Install/update extension / VSIX only	Install VSIX only
Ambiguous	Verify CLI works + install VSIX

Commands

Step 1: Verify ATK CLI works

npx -y --package @microsoft/m365agentstoolkit-cli atk --version

If this succeeds (prints a version): ATK CLI is available. The npx prefix automatically downloads the latest package on first use and caches it for subsequent runs.
If this fails: Check that Node.js 18+ and npm are installed. The npx command requires a working Node.js environment.

Step 2: ATK VS Code Extension (if requested)

code --install-extension TeamsDevApp.ms-teams-vscode-extension

Execution

Verify ATK CLI works by running npx -y --package @microsoft/m365agentstoolkit-cli atk --version
Report the result (version number / failure)
Install VS Code extension if requested
Explain that all ATK commands use the npx -y --package @microsoft/m365agentstoolkit-cli atk prefix — no global install needed

Safety Rules

MUST NOT skip errors — report failures clearly to the user
MUST use the exact package names and extension IDs above — do not substitute with other names or links