Skills · SkillTesting & SecurityDevOps & CloudReviewed

teams-app-developer

Build, test and deploy Microsoft 365 apps and agents for Teams and Copilot, from project creation through local testing to cloud deployment.

View on GitHub

Kind: Skill
Works with: Claude Code
Source: microsoft/skills @ 2130750147de
Path: .github/plugins/microsoft-365-agents-toolkit/skills/teams-app-developer/SKILL.md
License: MIT
Jobs: Implementation, Testing

InstallCopy it from the source repository, or sign in and let the assistant adapt it for your project.

# Microsoft 365 Agents Toolkit Skill

Build Microsoft 365 agents and Teams apps using the ATK CLI.

## AI Behavior Guidelines

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 `TENANT_ID`** 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](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+)
…