skilld
All skills
microsoft avatar

/teams-app-developer

@0bef15b
by microsoftmicrosoft/skills3.1k stars
351

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.

Ask your Agent

Use this Skill: https://skilld.dev/gh/microsoft/skills/teams-app-developer

This session only. Nothing lands on disk.

docsREADME.md

≈722 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Slack vs Teams: Platform Differences & Bridging Strategies

A practical guide for developers adding cross-platform support to an existing bot. Each document covers a category of differences, explains why they matter, and provides concrete mitigation strategies with effort estimates.

Documents

Document What It Covers
Feature Gaps Complete inventory of every RED and YELLOW gap with mitigations in both directions
Workflows Message-native workflow scenarios: standup, PTO, equipment, account health, break management, incidents
Messaging & Commands Messages, slash commands, events, threading, @mentions
UI Components Block Kit vs Adaptive Cards, modals vs dialogs, App Home vs personal tabs
Interactive Responses Ephemeral messages, button actions, message updates, confirmation dialogs
Identity & Auth User IDs, OAuth, signing/verification, tokens
Files & Links File upload/download, link unfurling/previews
Middleware & Handler Patterns Middleware chains, ack(), handler registration, error handling
Advanced Features Scheduling, workflows, shortcuts, channel ops, reactions, distribution
Infrastructure Transport, compute, storage, secrets, observability
Eval Harness Automated testing for expert routing, completeness, and code patterns

Eval Harness

The evals/ directory contains an automated test harness for the expert system. It validates three dimensions:

  • Routing — 51 test cases across all 7 domains verify queries route to the correct domain, clusters, and expert files
  • Completeness — 9 test cases check experts cover all required concepts for their domain
  • Patterns — 294 TypeScript code blocks across all experts are compiled in-memory to catch syntax errors

Pattern evals are fully deterministic (no API key needed). Routing and completeness evals use an LLM judge (OpenAI, Anthropic, or Azure OpenAI). See evals/README.md for setup and usage.

How to Read These Docs

Each difference follows this format:

  • What's different — the concrete behavioral gap
  • Impact — what breaks or degrades if you ignore it
  • Mitigation — one or more strategies ranked by effort and fidelity
  • Effort — rough hours to implement

Difficulty Ratings

Rating Meaning
GREEN Direct mapping exists. Mechanical conversion, minimal design decisions.
YELLOW Mapping exists but requires design decisions or trade-offs.
RED Platform gap — no equivalent exists. Requires redesign or custom workaround.

Source: SKILL.md on GitHub

Third-party checks

1 alert3mo3 checks · Risk SAFE
  • Gen Agent Trust Hub3mo

    This skill provides a comprehensive developer guide for building Microsoft 365 agents and Teams applications. It includes several security considerations such as handling untrusted user input, using dynamic execution in examples, and reading sensitive local files for protocol requirements. These patterns are presented with appropriate security warnings and architectural mitigations. See detailed analysis for more context.

  • Socket3mo

    No alerts

  • Snyk3mo

    Risk: HIGH · 1 issue

Provenance

Signed by skilld at 0bef15b. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 20 hours ago.

Activeupdated 3 months ago

README badge

README badge for microsoft/skills/teams-app-developer