feat: add microsoft-365-agents-toolkit skill#1909
Open
qfai wants to merge 21 commits into
Open
Conversation
Adds the Microsoft 365 Agents Toolkit skill to help AI coding agents build Teams apps, Declarative Agents, Custom Engine Agents, and Microsoft 365 integrations using the ATK CLI. **Skill capabilities:** - Scaffold new projects from 20+ templates (Declarative Agents, Custom Engine Agents, Teams bots, tabs, message extensions, Copilot connectors) - Local testing via Microsoft 365 Agents Playground (no M365 account needed) - Testing on real Teams via devtunnel + sideloading - Azure provisioning + cloud deployment (atk provision, atk deploy) - Comprehensive troubleshooting (401 errors, YAML issues, devtunnel, auth) - Slack-to-Teams migration (Block Kit → Adaptive Cards, Bolt → Bot Framework) **References included:** - create-project.md - template catalog + scaffold commands - test-playground.md - local testing workflow - test-teams.md - Teams sideloading workflow - provision-deploy.md - Azure provision + deploy - troubleshoot.md - error quick-reference and fixes - slack-to-teams.md - migration guide **Full skill** (100+ expert files) available in source repo: https://github.com/OfficeDev/microsoft-365-agents-toolkit/tree/dev/packages/vscode-extension/skills/microsoft-365-agents-toolkit Authored-by: Microsoft Corporation
github-actions
Bot
added
new-submission
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
main, but PRs should target staged.
The main branch is auto-published from staged and should not receive direct PRs.
Please close this PR and re-open it against the staged branch.
You can change the base branch using the Edit button at the top of this PR,
or run: gh pr edit 1909 --base staged
Contributor
There was a problem hiding this comment.
Pull request overview
Note
Copilot was unable to run its full agentic suite in this review.
Adds a new microsoft-365-agents-toolkit skill with supporting reference docs, and registers it in the skills index.
Changes:
- Introduces a new skill definition (
SKILL.md) for Microsoft 365 Agents Toolkit / ATK CLI workflows. - Adds multiple reference markdown docs (create, test, provision/deploy, troubleshoot, Slack migration).
- Updates the central skills catalog (
docs/README.skills.md) to include the new skill and its references.
Reviewed changes
Copilot reviewed 8 out of 8 changed files in this pull request and generated 6 comments.
Show a summary per file
| File | Description |
|---|---|
| skills/microsoft-365-agents-toolkit/references/troubleshoot.md | Adds troubleshooting quick-reference and fix steps for common ATK/Teams issues |
| skills/microsoft-365-agents-toolkit/references/test-teams.md | Documents Teams sideload testing workflow using devtunnel + ATK |
| skills/microsoft-365-agents-toolkit/references/test-playground.md | Documents local testing workflow with Agents Playground |
| skills/microsoft-365-agents-toolkit/references/slack-to-teams.md | Adds guidance and mapping notes for migrating Slack bots to Teams |
| skills/microsoft-365-agents-toolkit/references/provision-deploy.md | Documents provisioning/deployment workflows and common errors |
| skills/microsoft-365-agents-toolkit/references/create-project.md | Documents template selection and atk new scaffolding commands |
| skills/microsoft-365-agents-toolkit/SKILL.md | Defines the skill’s behavior guidelines, workflows, and reference links |
| docs/README.skills.md | Registers the new skill in the repository’s skills list |
Comment on lines
+5
to
+7
| | Error | Cause | Fix | | ||
| |-------|-------|-----| | ||
| | `AADSTS7000229: missing service principal` | `aadApp/create` missing `generateServicePrincipal: true` | Add field to YAML, re-provision | |
| @@ -0,0 +1,59 @@ | |||
| # Test with Agents Playground | |||
|
|
|||
| Test your bot locally using the Microsoft 365 Agents Playground. No M365 account, Azure tunnel, or app registration required. | |||
Comment on lines
+25
to
+31
| ## Step 3: Provision locally | ||
|
|
||
| ```bash | ||
| atk provision --env local -i false | ||
| ``` | ||
|
|
||
| After provisioning, verify `TENANT_ID` is in `.localConfigs`: |
| The full skill with 100+ expert files, sub-skill documentation, and Slack-to-Teams migration experts is available at: | ||
| [`OfficeDev/microsoft-365-agents-toolkit`](https://github.com/OfficeDev/microsoft-365-agents-toolkit/tree/dev/packages/vscode-extension/skills/microsoft-365-agents-toolkit) | ||
|
|
||
| Install the full skill: |
Comment on lines
+25
to
+27
| atk new -c <template-id> -n <project-name> -f /tmp -l <language> -i false | ||
| mv /tmp/<project-name>/. . | ||
| rmdir /tmp/<project-name> |
| grep TENANT_ID env/.env.local | ||
|
|
||
| # Add to .localConfigs: | ||
| echo "TENANT_ID=<value>" >> .localConfigs |
github-actions
Bot
added
the
branched-main
github-actions
Bot
added
external-plugin
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
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.
Adds the Microsoft 365 Agents Toolkit skill to the collection. Passes skill:validate.