Mycroft has come a long way over the last few years and our documentation has not always kept up. Skill Development is certainly one of these areas. New methods and tooling are available for developers, but the documentation still encourages old (sometimes deprecated) practices.
We want to update this section of the documentation with a Skill Development series, that provides a really easy to follow tutorial for beginners, and progresses through the many components available in a logical and structured way.
This issue is an attempt to provide the bones of that structure. Dot points are listed as check boxes because each is a page of documentation that needs to be compiled from existing sources, or written from scratch.
Skill Development
Intro
[x] Introduction to Mycroft Skill Development
[x] Your first Skill - including using msk create and a brief run through of what this generates
[x] Logging
[x] Intents
[x] Intro to intents - what are they, what are entities and overview of the built in intent parsers.
[ ] Specific how-to's eg setting up Home Assistant, or getting HA notifications via Mycroft
If any of these topics interest you, please consider learning about the topic and solidifying that learning by updating the documentation for it :grinning:
Mycroft has come a long way over the last few years and our documentation has not always kept up. Skill Development is certainly one of these areas. New methods and tooling are available for developers, but the documentation still encourages old (sometimes deprecated) practices.
We want to update this section of the documentation with a Skill Development series, that provides a really easy to follow tutorial for beginners, and progresses through the many components available in a logical and structured way.
This issue is an attempt to provide the bones of that structure. Dot points are listed as check boxes because each is a page of documentation that needs to be compiled from existing sources, or written from scratch.
Skill Development
Intro
msk create
and a brief run through of what this generatesManaging interactions, follow-ups and conversations
get_response()
and similar methodsAutomated Testing
Different Skill Types
GUI and Display Control
Voice User Experience - Designing your Skill
Language and internationalisation
Skill Submission
Other (where should these go?)
If any of these topics interest you, please consider learning about the topic and solidifying that learning by updating the documentation for it :grinning: