Teams App Patterns Skill

Full Teams app development patterns.

⚠️ Staleness Warning

Teams platform evolves rapidly. Last validated: February 2026 (TTK 5.x, Manifest v1.25)

Check: Teams Docs, Teams Toolkit

---

App Package

appPackage/
├── manifest.json
├── outline.png (32x32)
├── color.png (192x192)
└── declarativeAgent.json (optional)

Manifest Required Fields

• $schema, manifestVersion, version, id
• name.short, name.full
• description.short, description.full
• icons.outline, icons.color
• developer.*, validDomains

Bot Handler

class MyBot extends TeamsActivityHandler {
    constructor() {
        super();
        this.onMessage(async (context, next) => { ... });
    }
}

Adaptive Card Structure

{ "type": "AdaptiveCard", "version": "1.5", "body": [...], "actions": [...] }

Teams SDK

await microsoftTeams.app.initialize();
const context = await microsoftTeams.app.getContext();

SSO

const token = await microsoftTeams.authentication.getAuthToken();

Toolkit Commands

npx teamsapp package --env local
npx teamsapp validate --package-file ...
npx teamsapp preview --env local

Common Issues

Issue	Solution
Manifest fails	Check schema version
Bot not responding	Verify endpoint/tunnel
Sideload fails	Enable custom apps in admin

Synapses

See synapses.json for connections.