teams-app-developer
Builds, tests, and deploys Microsoft 365 apps and agents for Teams and Copilot. Includes sub-skills for project creation, local testing, cloud deployment, troubleshooting, and Slack-to-Teams migration. USE FOR: Teams agent, bot, tab, message extension, Declarative Agents, Custom Engine Agents, local testing, Agents Playground, Azure resource provision, remote deployment, Slack to Teams migration, cross-platform bot development, Block Kit to Adaptive Cards conversion. DO NOT USE FOR: general web development, non-bot/non-Teams projects.
Target: Office & team collaboration. Automatically collected · unverified.
Excerpt from the author’s documentation
Extracted from a fixed version of SKILL.md in its original language. This is the author’s documentation; installation, compatibility and runtime results have not been verified by this site.
Read the original English text
Topics in the source
- Microsoft 365 Agents Toolkit Skill
- AI Behavior Guidelines
- ATK CLI Setup
- CLI Global Options
- Sub-Skills
- Shared References
- Workflow Chains
- ATK Project Context Resolution
Build Microsoft 365 agents and Teams apps using the ATK CLI. 1. Testing Strategy: Recommend Agents Playground first (faster, no M365 needed). Use Teams workflow only if user explicitly requests it. 2. Environment Variables: NEVER hardcode secrets or make up placeholder values. Always ask users for real values. 3. Error Handling: Read error messages carefully. Check env/.env.local, .localConfigs, and atk auth list. Common pitfalls: AADSTS7000229 → aadApp/create missing generateServicePrincipal: true in YAML — add it and re-provision Missing TENANTID in .localConfigs → SDK uses wrong token authority → 401 from Bot Connector 401 persists after auth fix → devtunnel URL may be blacklisted — create a fresh tunnel See troubleshoot/troubleshoot.md for full diagnostic steps 4. Long-Running Commands — WAIT for completion: atk new, atk provision, atk deploy can take several minutes Always wait for completion before running the next step (timeout 120000ms+) 5. Local Service Startup — Hangs terminal (expected): npm run dev, npm start, python app.py, devtunnel host, etc. will hang — the process keeps running indefinitely ALWAYS run as a background process (isBackground=true) — NEVER use isBackgr
This is an excerpt. Refer to the complete source and its current requirements.
- Source repository
- microsoft/skills
- Source file
- .github/plugins/microsoft-365-agents-toolkit/skills/teams-app-developer/SKILL.md
- Fixed revision
- 9287b443662d2433c85621c7325ee72a0ce499b5
Sources and evidence
This record was collected automatically. Its documentation, suitability and runtime behavior have not been manually verified.
Author: Microsoft Skills · original repository metadata. Documentation review: Not reviewed. Last source check: 2026-11-10T19:02:08.014Z.
Categories are inferred from names, descriptions and paths. They do not establish compatibility.
License and attribution
MIT. Third-party content and copyright remain with their authors. Refer to the original license and terms.
Original license ↗Synchronization, copying and user-reported success do not mark a resource as runtime-tested.
Limitations and notes
- Collecting metadata does not mean this site has installed, adapted, runtime-tested or security-reviewed the resource.