Release 2.1-preview (with fixes)#2758
Merged
heyitsaamir merged 6 commits intopreviewfrom Apr 17, 2026
Merged
Conversation
## Summary - Adds comprehensive documentation for the `teams-dev` Claude Code skill - New unlinked page at `teams.md/docs/cli/guides/teams-dev-skill.md` - Explains how to invoke and use the skill for Teams bot development ## What's included - Overview of the teams-dev skill capabilities - How to invoke the skill (slash command, natural language) - Workflows: bot creation, infrastructure setup, SSO, troubleshooting - Example interactions - Prerequisites and important notes ## Why unlinked? This page is not added to `sidebars-cli.ts`, making it accessible via direct URL but not appearing in the navigation. This allows the documentation to exist for those who need it without cluttering the main navigation. ## Test plan - [ ] Verify the page renders correctly in Docusaurus - [ ] Confirm the page is not in sidebar navigation - [ ] Check all internal links work - [ ] Validate content accuracy against SKILL.md 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
## Summary - Add `teams-dev` agent skill with guides for bot development, infrastructure setup, SSO configuration, and troubleshooting - Add `.claude-plugin/marketplace.json` for Claude Code plugin marketplace registration - Add plugin package at `packages/cli/plugins/teams-sdk/` with skill references - Add `teams.md/docs/cli/guides/agent-skills.md` documentation with installation instructions for Claude Code and Cursor ## Test plan - [ ] Verify `marketplace.json` is valid JSON and follows the expected schema - [ ] Verify skill files are correctly structured under `packages/cli/plugins/teams-sdk/skills/teams-dev/` - [ ] Verify `/plugin install teams-sdk@teams` install command works in Claude Code - [ ] Verify agent-skills doc renders correctly with tabs for Claude Code / Cursor 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
## Summary - **Remove BotFramework code and links** — skill guides showed `TurnContext`/`sendActivity` patterns that don't compile with the Teams SDK, and linked to BotFramework docs - **Remove nonexistent FlaskAdapter** — Python SDK only has `FastAPIAdapter`; the integration guide now explains concepts and links to the llms.txt docs for actual code - **Fix project structure and commands** — match actual `teams project new` scaffold output (`src/index.ts`, `npm run dev`) - **Link to llms.txt docs** — instead of hardcoding code examples that go stale, point agents to the SDK's LLM-optimized documentation ## Test plan - [ ] Review that no BotFramework patterns remain in skill references - [ ] Verify llms.txt links resolve (e.g. `https://microsoft.github.io/teams-sdk/llms_docs/docs_typescript/in-depth-guides.txt`) - [ ] Manually test the skill with Claude Code on a "create a Teams bot" prompt — verify it doesn't generate BotFramework code 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude <noreply@anthropic.com>
## Summary
- The `readFileSync` mock in `manifest-upload-zip.test.ts` used
`filePath.startsWith('/mock/statics')` which only matches POSIX-style
paths
- On Windows, `path.join('/mock/statics', 'color.png')` produces
backslash paths (e.g. `\mock\statics\color.png`), so the mock fell
through to the real filesystem causing ENOENT
- Fix: use `path.join` to build the expected mock paths so they match on
all platforms
## Test plan
- [x] All 5 tests in `manifest-upload-zip.test.ts` pass on macOS
- [ ] Verify CI passes on Windows
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude <noreply@anthropic.com>
# Conflicts: # packages/cli/tests/manifest-upload-zip.test.ts # plugins/teams-sdk/skills/teams-dev/SKILL.md # plugins/teams-sdk/skills/teams-dev/references/guide-create-bot-app.md # plugins/teams-sdk/skills/teams-dev/references/guide-integrate-existing-server.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
What's included
Checklist
2.1-preview.{height}After merge, trigger the publish pipeline on
previewwith Public publish type.