My personal repository of skills, test, and whatnot.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Cortana Skills Kit

The Cortana Skills Kit is a suite of tools that helps you build custom, intelligent, personalized experiences for your users by empowering Cortana with new capabilities (or skills).

Note: Cortana Skills Kit is currently in public preview.

Cortana skills can be built using the Microsoft Bot Service. The framework enables you to build conversational experiences that support different types of interactions with users. You can design freeform or guided interactions using simple text strings, speech or use complex rich cards that contain text, images, audio and action buttons.

Cortana Skills Kit also enables you to personalize skill experiences for your users by requesting for and leveraging contextual data like the user profile and location information.

You can add natural language understanding to your skill by using the Language Understanding Intelligent Service (LUIS), which uses the power of machine learning to help extract meaning from natural language input. A LUIS app takes a user utterance and extracts intents and entities that correspond to activities in your skill.

You can add responsive UI to your skill on devices with screens using Adaptive Cards.

Also check out Question and Answer Maker that converts FAQs into bots in minutes via QNAMaker.


In this repository, you will find task-focused samples to help you build skills for Cortana. There are two areas; Consumer (third party) samples and Enterprise (Azure Active Directory) samples. Note: Enterprise skills tools and support are only offered to partners in Microsoft's Technology Adoption Program.



Task Description Action
Adaptive Cards Demonstrate how to build an adaptive card and respond to a submit action View Sample
Getting Started A basic Hello World skill. View Sample
OAuth V2 Demonstrate configuration of OAuth to get an Authorization token View Sample
OAuth & Graph Demonstrate OAuth to Graph connection to get information from Outlook contacts View Sample


Task Description Action
Deep Links Demonstrate deep linking into Microsoft Map (on Windows 10) to search a location (and check device has a screen) View Sample
OAuth V2 Demonstrate configuration of OAuth to get an Authorization token View Sample
OAuth & Graph Demonstrate OAuth to Graph connection to get information from Outlook contactss View Sample


This section is coming soon.


These resources provide additional information and support for developing Cortana Skills.

Support type Contact
this repository use the issues tab
Community support on StackOverflow StackOverflow
Community support on MSDN Social MSDN
Bot Builder SDK issues/suggestions BotBuilder GitHub


This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact with any additional questions or comments.

Legal Notices

Microsoft and any contributors grant you a license to the Microsoft documentation and other content in this repository under the Creative Commons Attribution 4.0 International Public License, see the LICENSE file, and grant you a license to any code in the repository under the MIT License, see the LICENSE-CODE file.

Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at

Privacy information can be found at

Microsoft and any contributors reserve all others rights, whether under their respective copyrights, patents, or trademarks, whether by implication, estoppel or otherwise.