---
name: teams-dev
description: Use this skill whenever the user mentions Microsoft Teams in a development context — whether they're building, integrating, configuring, debugging, or just…
---

# teams-dev

Use this skill whenever the user mentions Microsoft Teams in a development context — whether they're building, integrating, configuring, debugging, or just…

# teams-devby microsoft
Use this skill whenever the user mentions Microsoft Teams in a development context — whether they're building, integrating, configuring, debugging, or just…

`npx skills add https://github.com/microsoft/teams-sdk --skill teams-dev`Download ZIPGitHub

## Teams Bot Development & Infrastructure

This skill helps you create and manage Microsoft Teams bots using the Teams Developer CLI. Covers both bot application development (creating bot code) and infrastructure management (bot registration, SSO, credentials).

IMPORTANT: Use information and guidance provided within this skill and its reference guides. You may also use external public documentation only when it is explicitly linked from this skill or those guides. Do NOT perform arbitrary web searches or rely on unlisted external sources.

## Workflow Routing

Based on the user's request, route to the appropriate guide or handle directly:

### Complex Workflows (Use References)

Creating bot application code:

* Read and follow the Bot Application Development guide

* This covers: Scaffolding a new bot project with `teams project new` (TypeScript/C#/Python, templates, connecting to infrastructure)

Integrating Teams into an existing server:

* Read and follow the Integrate Existing Server guide

* This covers: Adding Teams bot functionality to an existing server using built-in adapters (ExpressAdapter for TypeScript, FastAPIAdapter for Python) or a custom adapter for any framework

Setting up bot infrastructure (Teams-managed bot & credentials):

* Read and follow the Bot Infrastructure Setup guide

* This covers: Prerequisites → Create Teams-managed bot → Save credentials → Verify

Setting up SSO authentication:

* Read and follow the SSO Setup guide

* This covers: Bot migration → AAD app configuration → OAuth connection → Manifest update → Verification

* Prerequisites: Existing bot (teamsAppId, botId), az CLI authenticated

Troubleshooting errors:

* Read the Troubleshooting guide

* Covers: Sideloading issues, auth errors, SSO problems, migration issues

### Simple Operations (Handle Directly)

For simple queries and updates, handle directly using the commands below:

List all apps:

```
`teams app list
`
```

View app details:

```
`teams app get <teamsAppId> --json
`
```

Check authentication status:

```
`teams status
`
```

Update CLI to latest version:

```
`teams self-update
`
```

## Common Operations

### Update Bot Endpoint

Use case: Endpoint URL changed (new ngrok/devtunnels session)

Command:

```
`teams app update <teamsAppId> --endpoint "https://new-endpoint-url/api/messages"
`
```

When to use:

* Ngrok URL changed (new session)

* Devtunnels URL changed

* Switching between different local development tunnels

Note: If the endpoint domain changed (not just the path), the CLI automatically updates `validDomains` in the manifest. This requires the user to reinstall the app in Teams for the change to take effect.

### Update Teams Developer CLI

Use case: Update the Teams Developer CLI to the latest version (recommended to stay current with new features and bug fixes)

Command:

```
`teams self-update
`
```

When to use:

* Periodically update to get latest features

* After bug reports or known issues

* When new CLI features are announced

Expected: CLI downloads and installs the latest version

### View App Details

Command:

```
`teams app get <teamsAppId> --json
`
```

Use case: Check current bot configuration, verify settings

### List All Apps

Command:

```
`teams app list
`
```

Use case: See all Teams apps you've created

## Resources

Teams SDK Documentation (llms.txt — optimized for LLM consumption):

* TypeScript: https://microsoft.github.io/teams-sdk/llms_docs/llms_typescript.txt

* Python: https://microsoft.github.io/teams-sdk/llms_docs/llms_python.txt

* C#: https://microsoft.github.io/teams-sdk/llms_docs/llms_csharp.txt

* Full TypeScript docs: https://microsoft.github.io/teams-sdk/llms_docs/llms_typescript_full.txt

* Full Python docs: https://microsoft.github.io/teams-sdk/llms_docs/llms_python_full.txt

* Full C# docs: https://microsoft.github.io/teams-sdk/llms_docs/llms_csharp_full.txt

Development Tunnels: See the Bot Infrastructure Setup guide for devtunnel setup instructions.

## More skills from microsoft
oss-growthby microsoftOSS growth hacker personapr-description-skillby microsoftTrigger this skill on any of the following intents:python-architectureby microsoftPython architect personasupply-chain-securityby microsoftSupply chain security expert personaskill-nameby microsoftDescription of what the skill does and when to use itwork-iterationsby microsoftList, create, and assign iterations for Azure DevOps projects and teams.djangoby microsoftBest practices for Django web development including models, views, templates, and testing.flaskby microsoftBest practices for Flask web development including routing, blueprints, and testing.

---

**Source**: https://github.com/microsoft/teams-sdk/tree/HEAD/plugins/teams-sdk/skills/teams-dev
**Author**: microsoft
**Discovered via**: mcpservers.org