teams-dev

Use this skill when the user is building or sending Adaptive Cards from a Microsoft Teams bot on `@microsoft/teams.cards` 2.1 — `AdaptiveCard`, `TextBlock`, inputs with `.withId()`, `ExecuteAction` with `SubmitData`, routing `card.action.<action>`, input validation, pasting Designer JSON, search-as-you-type choice sets. Triggers on "Teams card", "Adaptive Card", "Action.Execute", "card form", "card.action", "Adaptive Card Designer".

Use this skill when the user wants to test or debug a Microsoft Teams bot locally on Teams SDK 2.1 — Microsoft 365 Agents Playground (`agentsplayground`), accepting unauthenticated local requests (`dangerouslyAllowUnauthenticatedRequests`), the "No credentials configured … all incoming requests will be rejected" warning, mock activities, logs, replacing the deprecated DevTools. Triggers on "Agents Playground", "test Teams bot locally", "No credentials configured", "dangerouslyAllowUnauthenticatedRequests", "Teams DevTools replacement".

Use this skill when the user is adding LLM behaviour to a Microsoft Teams bot on Teams SDK 2.1 — calling OpenAI or Azure OpenAI directly with the `openai` SDK and `runTools()`, streaming into Teams, tools as `RunnableToolFunction`, conversation history in turn state, clarification cards, AI labels, feedback buttons, citations, suggested prompts. Triggers on "AI Teams bot", "OpenAI Teams", "function calling Teams", "streaming Teams response", "runTools", "Azure OpenAI Teams".

Use this skill on explicit request when the user asks for the Teams SDK 2.1 API reference — the `@microsoft/teams.*` packages and what each exports, `App` options, the handler context, activity routes, the `app.api` clients. Reference-only — does not auto-load.

Use this skill when the user is wiring authentication into a Microsoft Teams app on Teams SDK 2.1 — app credentials (`CLIENT_ID`/`CLIENT_SECRET`/`TENANT_ID`, managed identity), user sign-in with `app.addOAuthFlow()` (SSO or third-party OAuth), several connections, sign-in callbacks, Nested App Authentication for tabs. Triggers on "Teams SSO", "addOAuthFlow", "OAuth Teams bot", "signIn", "onSignInComplete", "NAA Teams", "managed identity Teams bot".

Use this skill when the user is driving the Microsoft Teams Developer CLI 3.x (`teams`) from a script, a CI job or an agent — `teams login`, `teams project new typescript`, `teams app create|get|update|doctor`, manifest and RSC edits, `--json` output with jq, non-interactive flags. Triggers on "teams CLI", "teams app update", "teams app create", "teams app doctor", "teams manifest", "teams self-update", "teams status".

Use this skill when the user is deploying a Microsoft Teams bot built on Teams SDK 2.1 — runtime environment variables (`CLIENT_ID`, `CLIENT_SECRET`, `TENANT_ID`, `MANAGED_IDENTITY_CLIENT_ID`), managed identity and federated credentials, the messaging endpoint, install and sideloading, organisation rollout, production hosting, secret rotation, sovereign clouds (`CLOUD`, US Gov, China). Triggers on "deploy Teams bot", "sideload Teams app", "Teams app production", "Teams sovereign cloud", "Teams bot endpoint", "managed identity Teams bot".

Use this skill when the user is building dialogs (task modules) in a Microsoft Teams bot on Teams SDK 2.1 — opening a dialog from a card with `OpenDialogData`, handling `dialog.open.<id>` and `dialog.submit.<action>`, returning an Adaptive Card or a web page, multi-step flows, dialogs opened from message extensions. Triggers on "Teams dialog", "task module", "modal in Teams", "dialog.open", "dialog.submit", "OpenDialogData".

Use this skill when the user wants a worked, end-to-end scenario for a Microsoft Teams app on Teams SDK 2.1 — a full walkthrough for an echo bot, an AI quote agent, an Adaptive Card form, a message-extension search command, or an SSO + Microsoft Graph bot. Triggers on "Teams bot example", "full example Teams", "end-to-end Teams scenario", "echo bot example", "Teams SSO example".

Use this skill when the user is calling Microsoft Graph from a Microsoft Teams app on Teams SDK 2.1 — `app.graph.call(endpoints…)` as the app, a `GraphClient` built from a user's OAuth token, `@microsoft/teams.graph-endpoints` parameters, beta endpoints, paging, permissions. Triggers on "Microsoft Graph Teams", "graph-endpoints", "app.graph", "list calendar events bot", "send mail Teams bot", "graph permissions".

Use this skill when the user is combining the Model Context Protocol or Agent2Agent with a Microsoft Teams bot on Teams SDK 2.1 — using a remote MCP server's tools in the agent, exposing the Teams bot as an MCP server (`find_user`, `notify`, `ask`, `request_approval`) with `@modelcontextprotocol/sdk`, bot-to-bot hand-off over A2A with `@a2a-js/sdk`. Triggers on "Teams MCP", "MCP server Teams", "expose Teams as MCP", "MCP client Teams bot", "A2A Teams", "human in the loop Teams".

Use this skill when the user is building Microsoft Teams message extensions on Teams SDK 2.1 — search commands (`message.ext.query`), action commands (`message.ext.submit`, `message.ext.open`), link unfurling (`message.ext.query-link`), item selection, settings pages. Triggers on "Teams message extension", "compose extension", "link unfurling", "message.ext.query", "search command Teams", "action command".

Use this skill when the user is sending or receiving messages in a Microsoft Teams bot on Teams SDK 2.1 — handling incoming messages, `send`/`reply`/`quote`, `MessageActivityInput`, typing indicators, mentions, targeted (private) messages, quoted replies, streaming and its limits, proactive notifications, receiving files, reactions. Triggers on "Teams bot message", "send a reply", "typing indicator", "stream a response", "proactive message", "targeted message", "quoted reply".

Use this skill when the user is writing the core wiring of a Microsoft Teams app on Teams SDK 2.1 — booting `App`, credentials from the environment, per-turn state (`state`), activity routing (`app.on`, `app.message`, `app.event`), middleware (`app.use`, `next`), plugins, logging, or running the app on an existing HTTP server with an adapter. Triggers on "Teams App class", "Teams middleware", "register a plugin", "activity routing", "turn state", "httpServerAdapter".

Use this skill when the user is building a tab inside a Microsoft Teams app on Teams SDK 2.1 — serving a static page with `app.tab()`, calling the agent from the page with `@microsoft/teams.client` and `app.function()`, using TeamsJS (`@microsoft/teams-js`) for context and dialogs, acquiring tokens with Nested App Authentication (NAA) and MSAL. Triggers on "Teams tab", "static tab", "configurable tab", "app.function", "teams.client", "Nested App Authentication", "TeamsJS".

Use this skill whenever the user mentions Microsoft Teams in a development context — whether they're building, integrating, configuring, debugging, or just asking questions. Covers bots, message extensions, embedded web apps, Adaptive Cards, dialogs, SSO, infrastructure, the Teams Developer CLI/SDK, and general Teams platform queries. If the word "Teams" appears, err on the side of invoking this skill.

Use this skill when the user is debugging a Microsoft Teams bot built on Teams SDK 2.1 — "bot did not reply", "All incoming requests will be rejected", 401/403 from or to Teams, sideload and install errors, SSO sign-in failures, Adaptive Card or dialog problems, streaming and AI issues, manifest checks. Triggers on "Teams bot not responding", "No credentials configured", "Teams 401", "Teams 403", "sideload error", "Teams app manifest invalid", "teams app doctor".