Index of every page on this site: llms.txt
All skills
microsoft avatar

/install-atk

@0d60658
by microsoftmicrosoft/skills3.2k stars
373
Run it yourself

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"

Use this Skill: https://skilld.dev/gh/microsoft/skills/install-atk

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈89 tokens for metadata: the name and description. ≈571 when used: this file.

Description uses 4.5% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈357 characters, or 4.5%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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

  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

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning5mo3 checks · Risk SAFE
  • Gen Agent Trust Hub5mo

    This skill facilitates the setup and update of the M365 Agents Toolkit. It utilizes standard developer tools like npx and the VS Code CLI to download and install official packages. While it processes user intent to execute commands, these actions are consistent with its documented purpose.

  • Socket5mo

    No alerts

  • Snyk5mo

    Risk: MEDIUM · 2 issues

Signed by skilld at 0d60658. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 5 months ago

README badge

README badge for microsoft/skills/install-atk