Teams App Developer
MicrosoftOfficialPublished by Microsoft
- Skill
- Tool integration
- Software development
- MIT
- Medium risk
AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
The teams-app-developer skill provides a structured framework for managing the lifecycle of Microsoft 365 agents and Teams applications. It leverages the ATK CLI to handle project scaffolding, local testing via the Agents Playground, cloud provisioning on Azure, and troubleshooting. The skill includes specialized guidance for migrating Slack bots to Teams, including converting Block Kit UI to Adaptive Cards, and provides access to an extensive library of micro-expert documentation for cross-platform development.
What it does
- Scaffolds new Microsoft 365 agents and Teams applications from templates.
- Facilitates local testing using the Agents Playground or Teams-specific environments.
- Automates Azure resource provisioning and cloud deployment workflows.
- Provides diagnostic procedures for common authentication and configuration errors.
- Supports migration of Slack bots to the Teams platform.
- Manages project configuration and environment variables for ATK-based projects.
When to use it
- When starting a new Teams app, bot, or Declarative Agent project.
- When you need to test an agent locally before deploying to the cloud.
- When migrating existing Slack bots to the Microsoft Teams ecosystem.
- When troubleshooting deployment or authentication issues in a Teams project.
- When you need to provision Azure infrastructure for a Teams application.
Advantages
- Streamlines the development lifecycle with standardized CLI commands.
- Reduces development time by offering a local testing playground.
- Provides expert-level guidance for complex cross-platform migrations.
- Ensures consistent configuration management across development environments.
- Includes robust error-handling protocols for common platform-specific pitfalls.
Usage examples
- “Create a new Teams bot project using the default template.”
- The agent will initialize a new project folder, configure the necessary YAML files, and guide you through the initial setup using the ATK CLI.
- “How do I migrate my Slack bot to Microsoft Teams?”
- The agent will initiate the slack-to-teams workflow, providing access to cross-platform bridging experts and guidance on converting UI components.
- “My Teams bot is returning a 401 error, how do I fix it?”
- The agent will trigger the troubleshooting workflow, checking your environment variables, tunnel status, and authentication configuration.
Install
Download the skill as a ZIP:
https://mp-staging.autogineer.com/agent-skills/microsoft/teams-app-developer/downloadUnzip it into the cross-client skills folder of your project:
mkdir -p .agents/skills && unzip teams-app-developer.zip -d .agents/skills
Documentation by Microsoft
Microsoft 365 Agents Toolkit Skill
Build Microsoft 365 agents and Teams apps using the ATK CLI.
AI Behavior Guidelines
Testing Strategy: Recommend Agents Playground first (faster, no M365 needed). Use Teams workflow only if user explicitly requests it.
Environment Variables: NEVER hardcode secrets or make up placeholder values. Always ask users for real values.
Error Handling: Read error messages carefully. Check
env/.env.local,.localConfigs, andatk auth list. Common pitfalls:AADSTS7000229→aadApp/createmissinggenerateServicePrincipal: truein YAML — add it and re-provisionMissing
TENANT_IDin.localConfigs→ SDK uses wrong token authority → 401 from Bot Connector401 persists after auth fix → devtunnel URL may be blacklisted — create a fresh tunnel
See troubleshoot/troubleshoot.md for full diagnostic steps
Long-Running Commands — WAIT for completion:
atk new,atk provision,atk deploycan take several minutesAlways wait for completion before running the next step (timeout 120000ms+)
Local Service Startup — Hangs terminal (expected):
npm run dev,npm start,python app.py,devtunnel host, etc. will hang — the process keeps running indefinitelyALWAYS run as a background process (
isBackground=true) — NEVER useisBackground=falsefor these commandsDo NOT wait for it to "finish" — verify startup by checking output for "listening on port" or tunnel URL
If errors appear, read logs, diagnose, fix, restart
Use a NEW terminal to launch Agents Playground or open Teams sideloading URL
Monitor App Logs: Periodically check background terminal output for runtime errors. If the app crashes, read the error, fix the root cause, and restart.
Telemetry Tagging: Before running any
atkCLI commands, set the session environment variable so all CLI invocations are tagged as skill-initiated:export ATK_CLI_SKILL=trueRun this once at the start of the session. All subsequent
atkcommands in the same terminal will inherit it.
ATK CLI Setup
atk --version # Must be > 1.1.5-betaIf ATK is not found or version is too old:
npm i -g @microsoft/m365agentstoolkit-cli@betaCLI Global Options
| Option | Meaning | Recommendation |
|---|---|---|
-i | Interactive mode | Always use -i false in automation to avoid hanging |
-f | Project folder | Default to be current directory, used when specifying a custom folder. When scaffolding a new project, this is the parent folder where the project folder will be created under. |
-h | Command help | Use atk <command> -h for quick syntax checks |
Sub-Skills
| Sub-Skill | When to Use | Reference |
|---|---|---|
| create-project | Scaffold new project from template, choose template, atk new | create-project/create-project.md |
| test-playground | Test locally with Agents Playground, agentsplayground, quick testing | test-playground/test-playground.md |
| test-teams | Run on Teams, devtunnel, sideload, Teams testing, test in Copilot | test-teams/test-teams.md |
| provision-deploy | Provision Azure resources, deploy to cloud, atk provision, atk deploy | provision-deploy/provision-deploy.md |
| troubleshoot | Fix errors, 401, port conflicts, YAML errors, stale bots | troubleshoot/troubleshoot.md |
| slack-to-teams | Migrate Slack bot to Teams, cross-platform bridging, Block Kit to Adaptive Cards | slack-to-teams/SKILL.md |
MANDATORY: Before executing any workflow, read the corresponding sub-skill document.
Shared References
manifest-and-yaml.md — Project files, YAML config, env vars, .localConfigs flow
commands.md — ATK CLI commands: package, validate, share, collaborate
templates.md — Complete template catalog with language support
experts/ — 100+ micro-expert files: Teams SDK, Slack SDK, cross-platform bridging, deploy, AI models, security, language conversion
docs/ — Platform comparison guides: UI, messaging, identity, infrastructure, feature gaps
Workflow Chains
Match user intent to the smallest valid workflow.
| User Intent | Workflow (read in order) |
|---|---|
| Build new app from scratch | create-project → test-playground |
| Test existing project locally | test-playground (recommended) or test-teams |
| Deploy to Azure | provision-deploy |
| Fix broken bot | troubleshoot → re-test |
| Migrate Slack bot to Teams | slack-to-teams |
MANDATORY: Before executing any slack-to-teams workflow, read slack-to-teams/SKILL.md first. The sub-skill contains a routed expert system with 100+ micro-expert files for cross-platform bot development.
ATK Project Context Resolution
Resolve config values only when missing. If a value is already known in the session, reuse it.
Step 1: Detect ATK Project
If m365agentstoolkit*.yml exists in the current folder, treat it as an ATK project and parse configuration.
Step 2: Resolve Common Configuration
Resolve variables referenced in m365agentstoolkit*.yml. Common variables:
AZURE_OPENAI_API_KEY
AZURE_OPENAI_ENDPOINT
AZURE_OPENAI_DEPLOYMENT_NAME
Step 3: Collect Missing Values
If required values are missing, ask the user for only the missing ones.
Refer to manifest-and-yaml.md for full config-file details.
Files
- ATTRIBUTION.mdAdded by AutoGineer906 B
- LICENSELicence file added by AutoGineer1.1 KiB
- SKILL.md7.6 KiB
- create-project/create-project.md8.1 KiB
- docs/README.md2.8 KiB
- docs/advanced-features.md7.0 KiB
- docs/feature-gaps.md46.3 KiB
- docs/files-and-links.md4.2 KiB
- docs/identity-and-auth.md4.3 KiB
- docs/infrastructure.md6.7 KiB
- docs/interactive-responses.md4.4 KiB
- docs/messaging-and-commands.md4.5 KiB
- docs/middleware-and-handlers.md4.4 KiB
- docs/ui-components.md6.9 KiB
- docs/workflows.md14.4 KiB
- experts/README.md8.6 KiB
- experts/_expert-ts.md2.2 KiB
- experts/analyzer.md14.0 KiB
- experts/bridge/app-distribution-packaging-ts.md14.2 KiB
- experts/bridge/channel-ops-graph-ts.md15.4 KiB
- experts/bridge/commands-slash-text-ts.md18.5 KiB
- experts/bridge/cross-platform-advisor-ts.md36.4 KiB
- experts/bridge/cross-platform-architecture-ts.md8.3 KiB
- experts/bridge/events-activities-ts.md22.4 KiB
- experts/bridge/files-upload-download-ts.md17.2 KiB
- experts/bridge/identity-oauth-bridge-ts.md19.8 KiB
- experts/bridge/index.md13.0 KiB
- experts/bridge/infra-compute-ts.md14.6 KiB
- experts/bridge/infra-observability-ts.md14.0 KiB
- experts/bridge/infra-secrets-config-ts.md13.2 KiB
- experts/bridge/infra-storage-ts.md14.3 KiB
- experts/bridge/interactive-responses-ts.md19.6 KiB
- experts/bridge/link-unfurl-preview-ts.md17.1 KiB
- experts/bridge/middleware-handlers-ts.md15.4 KiB
- experts/bridge/python-cross-platform.md9.3 KiB
- experts/bridge/rate-limiting-resilience-ts.md17.6 KiB
- experts/bridge/rest-only-integration-ts.md8.4 KiB
- experts/bridge/scheduling-deferred-send-ts.md17.8 KiB
- experts/bridge/shortcuts-extensions-ts.md17.5 KiB
- experts/bridge/transport-socketmode-https-ts.md14.3 KiB
- experts/bridge/ui-app-home-personal-tab-ts.md14.5 KiB
- experts/bridge/ui-block-kit-adaptive-cards-ts.md21.5 KiB
- experts/bridge/ui-legacy-attachments-cards-ts.md11.2 KiB
- experts/bridge/ui-modals-dialogs-ts.md21.4 KiB
- experts/bridge/workflow.composable-platform-ts.md13.7 KiB
- experts/bridge/workflows-automation-ts.md14.3 KiB
- experts/builder.md11.1 KiB
- experts/convert/bulk-conversion-strategy-ts.md12.8 KiB
- experts/convert/dependency-mapping-ts.md8.3 KiB
- experts/convert/index.md3.5 KiB
- experts/convert/java-to-ts-ts.md20.6 KiB
- experts/convert/js-to-ts-ts.md6.2 KiB
- experts/convert/json-serialization-ts.md11.0 KiB
- experts/convert/kotlin-to-ts-ts.md11.2 KiB
- experts/convert/ruby-to-ts-ts.md9.7 KiB
- experts/convert/type-mapping-ts.md10.1 KiB
- experts/deploy/aws-bot-deploy-ts.md14.6 KiB
- experts/deploy/aws-cli-reference-ts.md52.4 KiB
- experts/deploy/azure-bot-deploy-ts.md15.4 KiB
- experts/deploy/azure-cli-reference-ts.md16.9 KiB
- experts/deploy/index.md4.6 KiB
- experts/fallback.md2.1 KiB
- experts/index.md18.9 KiB
- experts/models/anthropic-ts.md7.8 KiB
- experts/models/bedrock-ts.md9.9 KiB
- experts/models/foundry-cloud-ts.md8.1 KiB
- experts/models/foundry-local-ts.md10.6 KiB
- experts/models/index.md5.8 KiB
- experts/models/openai-azure-openai-ts.md8.3 KiB
- experts/models/oss-openai-compatible-ts.md10.7 KiB
- experts/models/transformers-js-ts.md11.6 KiB
- experts/prompt-engineer.md14.7 KiB
- experts/researcher.md2.8 KiB
- experts/security/index.md1.2 KiB
- experts/security/input-validation-ts.md13.8 KiB
- experts/security/secrets-ts.md13.9 KiB
- experts/slack/bolt-assistant-ts.md9.9 KiB
- experts/slack/bolt-events-ts.md9.3 KiB
- experts/slack/bolt-java.md8.9 KiB
- experts/slack/bolt-oauth-distribution-ts.md10.9 KiB
- experts/slack/bolt-python.md9.5 KiB
- experts/slack/cli.app-management.md7.9 KiB
- experts/slack/cli.datastore-env.md8.6 KiB
- experts/slack/cli.getting-started.md8.0 KiB
- experts/slack/cli.local-dev-deploy.md8.4 KiB
- experts/slack/cli.manifest-triggers.md9.9 KiB
- experts/slack/index.md8.9 KiB
- experts/slack/runtime.ack-rules-ts.md9.8 KiB
- experts/slack/runtime.bolt-foundations-ts.md10.7 KiB
- experts/slack/runtime.shortcuts-ts.md11.0 KiB
- experts/slack/runtime.slash-commands-ts.md11.6 KiB
- experts/slack/runtime.socket-mode-ts.md9.5 KiB
- experts/slack/ui.block-kit-ts.md11.5 KiB
- experts/slack/ui.modals-lifecycle-ts.md13.3 KiB
- experts/slack/web-api-proactive-ts.md11.0 KiB
- experts/slack/workflow.slack-automations-ts.md10.2 KiB
- experts/teams/a2a.client-basics-ts.md9.7 KiB
- experts/teams/a2a.orchestrator-patterns-ts.md12.7 KiB
- experts/teams/a2a.server-basics-ts.md11.4 KiB
- experts/teams/ai.chatprompt-basics-ts.md8.1 KiB
- experts/teams/ai.citations-feedback-ts.md6.9 KiB
- experts/teams/ai.conversational-query-ts.md14.2 KiB
- experts/teams/ai.function-calling-design-ts.md9.0 KiB
- experts/teams/ai.function-calling-implementation-ts.md7.7 KiB
- experts/teams/ai.memory-localmemory-ts.md7.3 KiB
- experts/teams/ai.model-setup-ts.md6.6 KiB
- experts/teams/ai.rag-retrieval-ts.md7.4 KiB
- experts/teams/ai.rag-vectorstores-ts.md8.5 KiB
- experts/teams/ai.streaming-ts.md6.9 KiB
- experts/teams/auth.oauth-sso-ts.md10.1 KiB
- experts/teams/compat.botbuilder-interop-ts.md14.6 KiB
- experts/teams/dev.debug-test-ts.md14.1 KiB
- experts/teams/graph.usergraph-appgraph-ts.md9.0 KiB
- experts/teams/index.md9.8 KiB
- experts/teams/mcp.client-basics-ts.md9.5 KiB
- experts/teams/mcp.expose-chatprompt-tools-ts.md9.5 KiB
- experts/teams/mcp.security-ts.md10.4 KiB
- experts/teams/mcp.server-basics-ts.md9.9 KiB
- experts/teams/project.scaffold-files-ts.md12.2 KiB
- experts/teams/runtime.app-init-ts.md10.9 KiB
- experts/teams/runtime.manifest-ts.md12.3 KiB
- experts/teams/runtime.proactive-messaging-ts.md12.6 KiB
- experts/teams/runtime.routing-handlers-ts.md12.3 KiB
- experts/teams/state.storage-patterns-ts.md9.4 KiB
- experts/teams/teams-dotnet.md8.2 KiB
- experts/teams/teams-python.md8.3 KiB
- experts/teams/ui.adaptive-cards-ts.md12.9 KiB
- experts/teams/ui.dialogs-task-modules-ts.md15.1 KiB
- experts/teams/ui.message-extensions-ts.md15.6 KiB
- experts/teams/workflow.approvals-inline-ts.md12.4 KiB
- experts/teams/workflow.message-native-records-ts.md10.6 KiB
- experts/teams/workflow.sharepoint-lists-ts.md9.0 KiB
- experts/teams/workflow.state-driven-events-ts.md12.2 KiB
- experts/teams/workflow.triggers-compose-ts.md10.3 KiB
- experts/update-experts.md10.0 KiB
- provision-deploy/provision-deploy.md4.3 KiB
- test-playground/playground-cli.md4.6 KiB
- test-playground/playground.md4.5 KiB
- test-playground/test-playground.md1.1 KiB
- test-teams/test-teams.md4.9 KiB
- toolkit/README.md4.2 KiB
- toolkit/commands.md2.6 KiB
- toolkit/environments.md12.6 KiB
- toolkit/lifecycle-cli.md17.6 KiB
- toolkit/manifest-and-yaml.md6.0 KiB
- toolkit/playground.md7.6 KiB
- toolkit/publish.md9.3 KiB
- toolkit/templates.md6.7 KiB
- troubleshoot/troubleshoot.md20.2 KiB
experts/bridge/index.md
bridge-router
purpose
Route cross-platform bridging tasks to the minimal set of micro-expert files. Each expert covers bridging between Slack and Teams (or AWS and Azure) in either direction. Read only the clusters that match the user's request.
task clusters
Block Kit <-> Adaptive Cards
When: converting Block Kit JSON to Adaptive Card JSON or vice versa, mapping Slack blocks to card elements, mapping Adaptive Card elements to Block Kit blocks Read:
ui-block-kit-adaptive-cards-ts.mdCross-domain deps:../slack/ui.block-kit-ts.md(Slack Block Kit patterns),../teams/ui.adaptive-cards-ts.md(Teams Adaptive Card patterns)
Commands: Slash <-> Text
When: bridging slash commands between Slack and Teams, command registration differences, porting commands in either direction Read:
commands-slash-text-ts.mdCross-domain deps:../slack/runtime.slash-commands-ts.md(Slack command patterns),../teams/runtime.routing-handlers-ts.md(Teams app.message() patterns)
Events <-> Activities
When: mapping Slack events to Teams activity handlers or vice versa, event model differences Read:
events-activities-ts.mdCross-domain deps:../slack/runtime.bolt-foundations-ts.md(Slack event patterns),../teams/runtime.routing-handlers-ts.md(Teams activity routes)
Identity & OAuth Bridge
When: bridging Slack OAuth/identity and Azure AD/Entra ID, user mapping, SSO, OAuth implementation code (InstallationService, OAuthStateService, token refresh) Read:
identity-oauth-bridge-ts.mdCross-domain deps:../teams/auth.oauth-sso-ts.md(Teams OAuth/SSO flow),../teams/graph.usergraph-appgraph-ts.md(Graph API for user lookup)
Middleware <-> Handlers
When: converting Slack Bolt middleware chains to Teams handler patterns or vice versa, porting global/listener middleware, removing or adding ack() Read:
middleware-handlers-ts.mdCross-domain deps:../slack/runtime.bolt-foundations-ts.md(Slack middleware patterns),../teams/runtime.routing-handlers-ts.md(Teams handler patterns)
Modals <-> Dialogs
When: bridging Slack modals (views.open, viewSubmission, viewsUpdate, viewClosed, blockSuggestion in modals) and Teams task module / dialog flows Read:
ui-modals-dialogs-ts.mdCross-domain deps:../teams/ui.dialogs-task-modules-ts.md(Teams dialog patterns),ui-block-kit-adaptive-cards-ts.md(converting modal UI between Block Kit and Adaptive Cards)
App Home <-> Personal Tab
When: bridging Slack App Home tab (AppHomeOpenedEvent, views.publish) and Teams personal tab or bot welcome card Read:
ui-app-home-personal-tab-ts.mdCross-domain deps:events-activities-ts.md(event mapping),../teams/ui.adaptive-cards-ts.md(card construction),../teams/runtime.proactive-messaging-ts.md(background updates)
Legacy Attachments <-> Cards
When: bridging pre-Block Kit legacy Slack attachments (callback_id, color, actions, attachmentAction) and Adaptive Cards Read:
ui-legacy-attachments-cards-ts.mdCross-domain deps:../teams/ui.adaptive-cards-ts.md(Teams card patterns)
Transport: Socket Mode <-> HTTPS
When: bridging Slack Socket Mode, RTM, or HTTP Events API and Teams Bot Framework HTTPS transport Read:
transport-socketmode-https-ts.mdCross-domain deps:../teams/runtime.app-init-ts.md(Teams app startup),../teams/dev.debug-test-ts.md(ngrok/Dev Tunnels setup)
Infrastructure: Compute
When: bridging Lambda and Azure Functions, compute migration, serverless porting in either direction Read:
infra-compute-ts.mdinfra-secrets-config-ts.md(App Settings / env vars needed for compute config)
Infrastructure: Storage
When: bridging S3 and Blob Storage, DynamoDB and Cosmos DB, storage migration in either direction Read:
infra-storage-ts.mdCross-domain deps:../teams/state.storage-patterns-ts.md(IStorage interface for bot state on Cosmos DB)
Infrastructure: Secrets & Config
When: bridging AWS Secrets Manager and Azure Key Vault, SSM and App Configuration Read:
infra-secrets-config-ts.mdCross-domain deps:../security/secrets-ts.md(secrets management best practices)
Infrastructure: Observability
When: bridging CloudWatch and Application Insights, X-Ray and Azure Monitor, logging migration Read:
infra-observability-ts.mdCross-domain deps:../teams/dev.debug-test-ts.md(Teams SDK logging with ConsoleLogger)
Interactive Responses
When: bridging respond({ replace_original }), respond({ delete_original }), chat.update, chat.postEphemeral, deferred responses, response_url patterns between Slack and Teams Read:
interactive-responses-ts.mdCross-domain deps:../teams/ui.adaptive-cards-ts.md(card construction),../teams/runtime.proactive-messaging-ts.md(deferred update infrastructure)
Files: Upload & Download
When: bridging files.upload, files.sharedPublicURL, file events, file download/upload patterns between platforms Read:
files-upload-download-ts.mdCross-domain deps:../teams/graph.usergraph-appgraph-ts.md(Graph API auth),../teams/runtime.manifest-ts.md(supportsFiles flag)
Link Unfurl <-> Preview
When: bridging link_shared event and chat.unfurl() (Slack) with link preview cards (Teams) Read:
link-unfurl-preview-ts.mdCross-domain deps:../teams/ui.message-extensions-ts.md(message extension patterns),../teams/runtime.manifest-ts.md(messageHandlers domain config)
Shortcuts <-> Extensions
When: bridging Slack global shortcuts and message shortcuts with Teams message extensions or compose extensions Read:
shortcuts-extensions-ts.mdCross-domain deps:../teams/ui.message-extensions-ts.md(message extension patterns),../teams/ui.dialogs-task-modules-ts.md(task module details)
Scheduling & Deferred Send
When: bridging chat.scheduleMessage, chat.deleteScheduledMessage, reminders.add, timer-based patterns between platforms Read:
scheduling-deferred-send-ts.mdCross-domain deps:../teams/runtime.proactive-messaging-ts.md(proactive send infrastructure),../teams/state.storage-patterns-ts.md(persisting scheduled items)
Channel Ops <-> Graph
When: bridging conversations.create, conversations.archive, conversations.invite, conversations.kick, conversations.setTopic via Graph API Read:
channel-ops-graph-ts.mdCross-domain deps:../teams/graph.usergraph-appgraph-ts.md(Graph API auth),identity-oauth-bridge-ts.md(user ID mapping)
Workflows <-> Automation
When: bridging Slack Workflow Builder workflows, custom workflow steps (workflow_step_execute), and Power Automate flows Read:
workflows-automation-ts.mdCross-domain deps:../teams/ui.adaptive-cards-ts.md(card construction for bot-driven workflows),../teams/runtime.proactive-messaging-ts.md(flow-triggered bot messages)
Composable Workflow Platform
When: composable workflow architecture, reusable workflow engine, WorkflowDefinition, template workflows, five-element lifecycle, workflow platform design, workflow operating layer Read:
workflow.composable-platform-ts.mdCross-domain deps:../teams/workflow.sharepoint-lists-ts.md(state),../teams/workflow.message-native-records-ts.md(visibility),../teams/workflow.triggers-compose-ts.md(triggers),../teams/ai.conversational-query-ts.md(intelligence),../teams/workflow.approvals-inline-ts.md(routing)
App Distribution & Packaging
When: bridging Slack App Directory listing, OAuth install flow, InstallationStore, org-level installs and Teams sideloading, app packaging, Teams Admin Center Read:
app-distribution-packaging-ts.mdCross-domain deps:identity-oauth-bridge-ts.md(identity model bridge),../teams/runtime.manifest-ts.md(Teams manifest creation)
Rate Limiting & Resilience
When: bridging rate limiting patterns, retry logic, throttling handling, proactive broadcast resilience, circuit breaker between platforms Read:
rate-limiting-resilience-ts.mdCross-domain deps:../teams/runtime.proactive-messaging-ts.md(proactive send infrastructure),../teams/graph.usergraph-appgraph-ts.md(Graph API throttling)
Cross-Platform Advisor
When: starting a cross-platform bridging project, assessing scope, making bridging decisions, "help me add Teams", "help me add Slack", "help me migrate", "what do I need to do to bridge" Read:
cross-platform-advisor-ts.mdNote: This expert orchestrates the full bridging workflow — it detects direction, scans the codebase, classifies the bot profile, walks through decisions, then routes to the individual experts above for implementation.
Cross-Platform Architecture
When: hosting both bots in a single server, shared Express, dual bot, single process, platform-agnostic service layer, deployment architecture Read:
cross-platform-architecture-ts.mdCross-domain deps:../slack/runtime.bolt-foundations-ts.md(Slack setup),../teams/runtime.app-init-ts.md(Teams setup)
Python Cross-Platform
When: Python dual-platform, Python unified server, slack_bolt + microsoft_teams, FastAPI shared server, Python Slack + Teams, Tier 2, Python adaptation
Read:
python-cross-platform.mdCross-domain deps:../slack/bolt-python.md(Slack Python SDK),../teams/teams-python.md(Teams Python SDK),cross-platform-architecture-ts.md(architecture patterns to adapt)
REST-Only Integration
When: Java, C#, Go, Ruby, no SDK, raw HTTP, Bot Framework REST API, Slack Events API, Slack Web API, manual JWT validation, manual signature verification, language without native SDK Read:
rest-only-integration-ts.mdCross-domain deps:cross-platform-architecture-ts.md(if mixing REST with TS SDK)
Composite: Full Slack <-> Teams Bridge
When: complete end-to-end cross-platform bridging between Slack and Teams bots Read:
ui-block-kit-adaptive-cards-ts.mdcommands-slash-text-ts.mdevents-activities-ts.mdidentity-oauth-bridge-ts.mdmiddleware-handlers-ts.mdtransport-socketmode-https-ts.mdui-modals-dialogs-ts.mdui-app-home-personal-tab-ts.mdui-legacy-attachments-cards-ts.mdinteractive-responses-ts.mdfiles-upload-download-ts.mdlink-unfurl-preview-ts.mdshortcuts-extensions-ts.mdscheduling-deferred-send-ts.mdchannel-ops-graph-ts.mdworkflows-automation-ts.mdapp-distribution-packaging-ts.mdrate-limiting-resilience-ts.mdCross-domain deps:../teams/project.scaffold-files-ts.md(scaffold the new Teams project),../teams/runtime.app-init-ts.md(initialize the Teams app),../teams/runtime.manifest-ts.md(create the Teams manifest)
Composite: Full AWS <-> Azure Bridge
When: complete end-to-end infrastructure bridging between AWS and Azure Read:
infra-compute-ts.mdinfra-storage-ts.mdinfra-secrets-config-ts.mdinfra-observability-ts.mdCross-domain deps:../security/secrets-ts.md(secrets hygiene for Azure)
combining rule
If a request involves both Slack↔Teams app bridging and AWS↔Azure infra bridging, read files from both composite clusters.
file inventory
app-distribution-packaging-ts.md | channel-ops-graph-ts.md | workflow.composable-platform-ts.md | commands-slash-text-ts.md | cross-platform-advisor-ts.md | cross-platform-architecture-ts.md | events-activities-ts.md | files-upload-download-ts.md | identity-oauth-bridge-ts.md | infra-compute-ts.md | infra-observability-ts.md | infra-secrets-config-ts.md | infra-storage-ts.md | interactive-responses-ts.md | link-unfurl-preview-ts.md | middleware-handlers-ts.md | python-cross-platform.md | rate-limiting-resilience-ts.md | rest-only-integration-ts.md | scheduling-deferred-send-ts.md | shortcuts-extensions-ts.md | transport-socketmode-https-ts.md | ui-app-home-personal-tab-ts.md | ui-block-kit-adaptive-cards-ts.md | ui-legacy-attachments-cards-ts.md | ui-modals-dialogs-ts.md | workflows-automation-ts.md
<!-- Updated 2026-02-27: Reframed from migrate-router to bridge-router — bidirectional cross-platform bridging between Slack↔Teams and AWS↔Azure. Renamed all files to platform-neutral names. -->
<!-- Updated 2026-02-27: Added cross-platform-architecture-ts (dual-bot hosting) and rest-only-integration-ts (SDK-less HTTP patterns for Java/C#/Go). -->
<!-- Updated 2026-02-28: Added RED gap workarounds and YELLOW gap best practices to expert files: interactive-responses-ts (R1 refresh.userIds, Y11 _version), events-activities-ts (R2 reaction→button, Y16 RSC manifest), ui-modals-dialogs-ts (R3 cancel TTL, R4/R6 step routing, R5 validation re-render), scheduling-deferred-send-ts (R7 Service Bus), link-unfurl-preview-ts (Y7 cache middleware), commands-slash-text-ts (Y1 text+manifest), rate-limiting-resilience-ts (Y17 retry+p-queue). -->
<!-- Updated 2026-03-05: Added workflow.composable-platform-ts for composable workflow operating layer architecture -->
<!-- Updated 2026-02-28: Added remaining missing patterns: events-activities-ts (Y2 replyWithBroadcast helper, Y3 Graph thread replies), files-upload-download-ts (Y4/5/6 sendFile helper), ui-modals-dialogs-ts (Y9 dynamic selects), ui-block-kit-adaptive-cards-ts (Y14 Action.ShowCard confirmation), link-unfurl-preview-ts (Y15 manifest domain generator), transport-socketmode-https-ts (R10 Azure Relay for on-prem). -->
Requirements and compatibility
Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta
“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.
Needs: Needs an API key, Needs Python, Needs Node.js
Security
What our scanner noticed· Medium risk
- Possible data-exfiltration endpoints
- Instructions that use the network
- Downloads piped into a shell
A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.
Attribution and licence
- Published by
- Microsoft
- Publisher
- Microsoft (Official)
- Source
- microsoft/skills · .github/plugins/microsoft-365-agents-toolkit/skills/teams-app-developer · commit 0696600
- Licence
- MIT License (redistribution allowed)
- LICENSE (added by AutoGineer from LICENSE)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
AutoGineer is not affiliated with or endorsed by Microsoft.
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download teams-app-developer.zip