Welcome to the OVOS Skills Store!

This is OpenVoiceOS' Skill Store, and is one of the app stores enabled by default with OSM. This is where OVOS community developers can submit their skills. It's also where the OVOS dev team hosts our own skills!

Submitting a Skill is easy, and relatively painless, though a few steps need to be completed before your Skill can be accepted:

1. The version of your Skill which you intend to publish must be associated with a git tag.

2. You must create a JSON file for your Skill like the ones already present. Simply copy an existing file, and replace all the data with information about your Skill (see below.)

3. Your skill must be licensed under an OSI-approved open-source license, or released into the public domain, except by special permission from the OVOS dev team. Such permission is unlikely to be granted except in cases where your Skill integrates Mycroft or OVOS with software that is a) extremely valuable to users, b) extremely popular, c) privacy-respecting, and d) cannot be integrated any other way. (We're talking about things like a big-name streaming service, or integrating with a video game console. Big things with no open-source alternative. Submissions containing utility Skills under a proprietary license will be summarily closed as invalid.)

Once you have completed these steps, you can create a pull request to this repository, adding your JSON file. Your Skill will be reviewed as soon as possible by one or more OVOS developers or authorized Skill Reviewers.

Once your Skill has been reviewed, and the pull request is merged, your Skill should immediately be listed on the OVOS Skills Store, and become available for installation on any system running OSM!

---

On the JSON file:

• branch refers to the git tag mentioned above, and can be omitted if the tag is in the URL.
• desktop_file should be true if your Skill is associated with a FreeDesktop-compliant desktop entry. Most Skills should leave this false.
• systemDeps should be true if your skill requirements include system packages, or false if not.
• icon can be omitted if the Skill's icon can be resolved another way by OSM.
• folder should be omitted unless you know your target device requires it.
• categories can list as many categories as you like, and the Skill will appear under each in the Skills Store.category refers to the Skill's primary category, which is the one that will appear next to its entry when clicked.
• tags refers to other search terms you'd like to apply to this Skill. You are encouraged to add as many tags as you feel are appropriate. These will be carefully checked as part of the review process.