 Hey, welcome to my crop sound bites. We wanted to start a new series of short chart videos that just do an introduction to some key topics that you'll Run into when you're getting started with my crop development. I'm Gez. I'm the community development Person can't remember my title Yeah, yeah, so I do and develop relations at my croft and Barry I Go by stratus in the community. I'm just a community member. I helped to maintain the Home assistant skill inside of my croft. I work for Red Hat and yeah, I just like to tinker around in Python So I'm just a regular guy unlike unlike my esteemed colleague here who knows all the Python I know enough to get by I Unfortunately, don't yet know all of Python Not sure how many people do But yeah, all right, let's let's get into it the first video this video is going to be about the micro skills kit So the skills kit is a small Python package that gets distributed with your installation of my croft And it just helps you to get started really quickly with some basic Basic skills and then also submit them to the marketplace When they're ready for broader sharing, so let's jump into the command line and and take a look at it So we're gonna look at my croft-msk Which if you added the helper commands to your path should should be on there, but if you could enter We'll get some help text to show how we can use it If it does say that, you know the my croft-msk command cannot be found Then you'll find that in my croft core slash bin slash my croft-msk So you can always call it directly from there If it's not on your path So there it is But today we're just gonna look at create and so we're gonna create a new skill so my croft-msk create Short skill name. So Let's do let's talk about ice cream. It's a pretty universal thing Generally universal thing looks good and Now we want to enter some some Example utterances or phrases and things that users are going to say that we want our skill to respond to So in our case might be something like Do you like a certain flavor of ice cream? and So what we can do is because we don't know what flavor And we want people to be asked about any flavor, right? So so we're gonna create what's called an entity using curly braces. So do you like curly brace flavor? Ice cream and what this will mean is that users can then ask you about chocolate ice cream They can ask about mint ice cream. They can ask about any any flavor of ice cream and that flavor entity is gonna be available in our skill for us to use Cool We can add as many as we like, but for an example skill, let's just let's just stick with a simple one What are we gonna say in response? Well, if we're a shop, why don't we say? Coming right up All right, and what we can do is Let's put in a second one that that uses our flavor Entity so we can we can do the same curly braces flavor And then comma coming right up again or Whatever Yeah, there you go So what my cross gonna do then is is it will respond with with one of those responses and so sometimes it'll say the The name of the flavor and sometimes I'm like and that just adds a bit of variation So that users don't just get the exact same thing every time Cool. Let's move on So we've we've set up what people are gonna say to ask you and what we're gonna say in return and then the next bits are around You know Providing descriptions around what the skills about so the one line description is the first line that comes in your read me on your On your repo. It's also what's gonna show in the micro marketplace in the in the short view You want to try and keep this below 50 characters. We can you know That's all the ice cream perfect And then in the long description we can provide as much text as we like You know, you don't want to overload people They're only gonna read so much but you know as much as you need in there when people click through to your skill It'll show a full page. That's just your skills so you can you can enter in as much information as you like Cool Also, you can put your name obviously Often people put their their github handle as well, but Whatever and now we have an icon so for each skill If you look in the marketplace, you'll you'll notice that there is an icon if you go to that link You'll be able to see an enormous list of options. I know for a fact that ice dash cream exists so We can use that cool And and then you can pick a color for that as well and Changes the color in a few different places, but predominantly for the icon by default if you just enter It'll use the micro light blue that is that that hatch value there Next is where the skill comes in the marketplace. So you'll see that there's a few different categories You can the first one is the primary category and then you can pick secondary ones as well But the primary category is is where it's going to sit in that marketplace So entertainment sounds good once you're done. You can just enter to move on to the next question Tags are an alternative way of searching for things or filtering tags You can make them whatever you like or you can have no tags at all That's fine, too. This is a quick way of choosing a license. So By default we provide a few few, you know common options that Are going to be fine for the marketplace. We do require that skills That are listed in the in the micro marketplace have an open license because then it means that we are We're guaranteed that we can freely distribute that but by default everything in my crop is an Apache version 2.0 license You can also skip it and not have a license. It just went won't get into the marketplace just yet Here's where we can select whether or not to create a manifest manifest file it'll let us define Dependencies for our skill so we might have Python dependencies We might have system packages that we need to run our skill Or we might require other skills are installed for our skill to work So if we think that we're going to need those then we would answer yes I think let's do yes for the moment just so that We'll have that file there and we can take a look at it in another video. Sure thing And then whether we want to upload it to GitHub or not. So and You know, particularly if you don't not overly familiar with GitHub It's a nice easy way to get get set up quickly and easily Cool, that's it. We now have a new skill and It's located at up slash mycroft slash skills slash ice cream shop skill and It's got a bunch of files in it. We will take a look at what's in there in another video We just wanted to keep these nice and short and sharp in this video We just briefly covered what MSK is and how it helps you basically set up a hello world project for mycroft without having you do much Typing it basically holds your hand through the hello world process and it sets up a nice templated project for you in order to help you along so in the next video We're we'll talk a little bit about the files that it creates and and what you might want to look at in some of The files, but for this one, I think we're I think we're pretty happy with just having created our hello world ice cream shop Yeah, yeah, and if you've got mycroft running on the device that you would using this on then it would already be adopted It would already be picked up by mycroft and running so at this point you could you could trigger the device and and Ask it whatever it is your sample phrase was and it should respond appropriately Good good, then we'll see you in the next video See you then