JantonioFC 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
npxprefix 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
npxcommand 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 atkprefix — 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
Activation Triggers
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"