Official agent skill

Teams App Developer

by microsoft in microsoft/work-iq

Build, test, and deploy code-based Teams apps using the M365 Agents Toolkit CLI.

OfficialCustom licenceAuto-check: notesDevOps & Cloud

Install Teams App Developer

skills CLI
$ npx skills add microsoft/work-iq --skill teams-app-developer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install microsoft/work-iq teams-app-developer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/microsoft/work-iq.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/microsoft-365-agents-toolkit/skills/teams-app-developer .claude/skills/teams-app-developer && rm -rf skills-src

Use ~/.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/

Facts

Skill name
teams-app-developer
GitHub stars
1k
Token cost
~1.8k tokens
SKILL.md length
717 words
Files
158
Skills in repo
18
Repo updated
First seen
Licence
Custom licence

At a glance

Build, test, and deploy code-based Teams apps using the M365 Agents Toolkit CLI.

  • Works in 3 steps: Detect ATK Project → Resolve Common Configuration → Collect Missing Values
  • : Custom Engine Agents (CEA)
  • SKILL.md covers AI Behavior Guidelines, ATK CLI Setup, CLI Global Options and Sub-Skills, plus 3 more sections
  • Calls npm and python; needs AZURE_OPENAI_API_KEY

What it does

Teams App Developer is an agent skill from microsoft/work-iq, published by the product's own GitHub organization. Build, test, and deploy code-based Teams apps using the M365 Agents Toolkit CLI. USE FOR: Custom Engine Agents (CEA), Teams bots, tabs, message extensions, Agents Playground local testing, Azure provision/deploy, Slack-to-Teams migration, cross-platform bot development, Block Kit to Adaptive Cards conversion, AI model integration (OpenAI/Azure/Anthropic/Bedrock). DO NOT USE FOR: declarative agents — use the declarative-agent-developer skill instead. Triggers: "build a teams bot", "custom engine agent", "CEA"…

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 161 other files (for example `create-project/create-project.md`, `docs/README.md` and `docs/advanced-features.md`).

It sits in DevOps & Cloud, covering Chatbots and conversational support. It works with Microsoft Teams, Microsoft Azure, Slack and Microsoft 365. The repository describes itself as: MCP Server and CLI for accessing Work IQ.

When your agent uses it

  • : Custom Engine Agents (CEA)
  • Message extensions
  • Agents Playground local testing
  • Azure provision/deploy

Example prompts

  • “build a teams bot”
  • “custom engine agent”
  • “teams agent”
  • “/teams-app-developer”

Requirements

  • Python 3
  • A credential in AZURE_OPENAI_API_KEY

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Detect ATK Project
  2. Resolve Common Configuration
  3. Collect Missing Values

What it can do on your machine

Read from SKILL.md and the folder at commit 1060873. 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:

    • npm
    • python

    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

Teams App Developer loads about 1.8k tokens when it runs. Until then it costs about 186 tokens; SKILL.md has 717 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~186
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

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:28
    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 717 words (~1,775 tokens).

“Build code-based Microsoft 365 agents and Teams apps (CEA, bot, tab, message extension) using the ATK CLI.”

— opening of SKILL.md by microsoft, Custom licence
name
teams-app-developer

Read the full SKILL.md on GitHub

Files

SKILL.md and 157 other files in plugins/microsoft-365-agents-toolkit/skills/teams-app-developer of microsoft/work-iq.

  • 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 141 more

Open the folder on GitHubat commit 1060873

Compare with similar skills

Teams App Developer 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.

Teams App Developer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Teams App Developer this skillmicrosoft/work-iq1k—~1.8kAutomated safety check: NotesCustom licence
Teams App Developermicrosoft/skills3.1k—~1.9kAutomated safety check: NotesMIT
Capacitymicrosoft/GitHub-Copilot-for-Azure2552 repos~1.7kAutomated safety check: PassMIT
Deploy Modelmicrosoft/GitHub-Copilot-for-Azure2551 repos~1.8kAutomated safety check: PassMIT
Azure Mgmt Botservice Dotnetmicrosoft/skills3.1k—~2.6kAutomated safety check: PassMIT
Azure AI Voicelive Dotnetmicrosoft/skills3.1k6 repos~2.3kAutomated safety check: PassMIT

Similar skills

  • Teams App Developer

    microsoft/skills

    Official

    Builds, tests, and deploys Microsoft 365 apps and agents for Teams and Copilot.

    3.1k GitHub stars~1.9k tokensUpdated yesterday
    Documents & OfficeAuto-check: notes
  • Capacity

    microsoft/GitHub-Copilot-for-Azure

    Official

    Discovers available Azure OpenAI model capacity across regions and projects.

    255 GitHub starsUsed in 2 repos~1.7k tokens
    DevOps & CloudAuto-check passed
  • Deploy Model

    microsoft/GitHub-Copilot-for-Azure

    Official

    Unified Azure OpenAI model deployment skill with intelligent intent-based routing.

    255 GitHub starsUsed in 1 repo~1.8k tokens
    DevOps & CloudAuto-check passed
  • Official

    Azure Resource Manager SDK for Bot Service in .NET. An agent skill from microsoft/skills.

    3.1k GitHub stars~2.6k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Official

    Azure AI Voice Live SDK for .NET. An agent skill from microsoft/skills.

    3.1k GitHub starsUsed in 6 repos~2.3k tokens
    Backend & APIsAuto-check passed
  • Develops and administers SAP Build Work Zone, advanced edition digital workplace solutions.

    460 GitHub stars~3.3k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed

More from microsoft/work-iq

All 18 skills in this repo
  • Official

    Create, build, deploy, and localize declarative agents for M365 Copilot and Teams.

    1k GitHub stars~3.2k tokensUpdated today
    Auto-check passed
  • M365 Agent Evaluator

    microsoft/work-iq

    Official

    A skill your agent uses when a user wants to create, run, or analyze evaluation suites for Microsoft 365 Copilot declarative agents with the public @microsoft/m365-copilot-eval CLI.

    1k GitHub stars~2k tokensUpdated today
    Auto-check: notes
  • Install Atk

    microsoft/work-iq

    Official

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

    1k GitHub stars~668 tokensUpdated today
    Auto-check passed
  • UI Widget Developer

    microsoft/work-iq

    Official

    Build MCP servers for Copilot Chat using the OpenAI Apps SDK or MCP Apps SDK widget rendering support (any language).

    1k GitHub stars~6.1k tokensUpdated today
    Auto-check: notes
  • Workiq

    microsoft/work-iq

    Official

    WorkIQ tools for Microsoft 365 workplace data and actions. An agent skill from microsoft/work-iq.

    1k GitHub stars~15k tokensUpdated today
    Auto-check passed
  • Slack To Teams

    microsoft/work-iq

    Official

    Sub-skill of microsoft-365-agents-toolkit. An agent skill from microsoft/work-iq.

    1k GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed

Questions about Teams App Developer

What does Teams App Developer do?

Build, test, and deploy code-based Teams apps using the M365 Agents Toolkit CLI. Teams App Developer is an agent skill from microsoft/work-iq, published by the product's own GitHub organization. Build, test, and deploy code-based Teams apps using the M365 Agents Toolkit CLI.

When should I use Teams App Developer?

Teams App Developer fits situations like: : Custom Engine Agents (CEA); message extensions; agents Playground local testing; azure provision/deploy.

How do I install Teams App Developer in Claude Code?

Run `npx skills add microsoft/work-iq --skill teams-app-developer -a claude-code`. Or copy the skill folder (plugins/microsoft-365-agents-toolkit/skills/teams-app-developer in microsoft/work-iq) into .claude/skills/teams-app-developer in your project. Claude Code loads it when a task matches its description.

How do I install Teams App Developer in Codex?

Run `npx skills add microsoft/work-iq --skill teams-app-developer -a codex`. Or copy the skill folder (plugins/microsoft-365-agents-toolkit/skills/teams-app-developer in microsoft/work-iq) into .agents/skills/teams-app-developer in your project. Codex loads it when a task matches its description.

Can I use Teams App Developer 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 microsoft/work-iq --skill teams-app-developer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/teams-app-developer, .gemini/skills/teams-app-developer, .github/skills/teams-app-developer and .opencode/skills/teams-app-developer in your project.

What does Teams App Developer need to run?

Going by SKILL.md and its folder, Teams App Developer needs the command-line tools its instructions call (npm and python) and credentials named AZURE_OPENAI_API_KEY. Our summary lists: Python 3; A credential in AZURE_OPENAI_API_KEY.

Does Teams App Developer 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 Teams App Developer 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 Teams App Developer use?

Teams App Developer 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 Teams App Developer use?

About 1.8k tokens (SKILL.md is roughly 7.1k 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 Teams App Developer?

Skills that share tags, products or a category with Teams App Developer: Teams App Developer (microsoft/skills, 3.1k stars), Capacity (microsoft/GitHub-Copilot-for-Azure, 255 stars), Deploy Model (microsoft/GitHub-Copilot-for-Azure, 255 stars) and Azure Mgmt Botservice Dotnet (microsoft/skills, 3.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Teams App Developer?

microsoft (a GitHub organization, an official publisher) maintains it in microsoft/work-iq, which has 1,027 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 7, 2026.

Source: microsoft/work-iq on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.