---
name: microsoft/install-atk
source: https://app.decimal.ai/s/microsoft-install-atk@1/SKILL.md
source_sha256: f2be6d4aad2d
---

# 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:
```bash
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

```bash
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)

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

## Execution

1. **Verify** ATK CLI works by running `npx -y --package @microsoft/m365agentstoolkit-cli atk --version`
2. Report the result (version number / failure)
3. Install VS Code extension if requested
4. 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