OVOS Workshop

Base classes, decorators, and helpers for building skills and applications for OpenVoiceOS.

Install

pip install ovos-workshop

Runtime dependencies include ovos-yes-no-plugin and ovos-option-matcher-fuzzy-plugin, which back the ask_yesno and ask_selection skill methods.

Quick Start

from ovos_workshop.skills.ovos import OVOSSkill
from ovos_workshop.decorators import intent_handler

class HelloWorldSkill(OVOSSkill):

    @intent_handler("hello.intent")
    def handle_hello(self, message):
        self.speak_dialog("hello.response")

def create_skill():
    return HelloWorldSkill()

Register in pyproject.toml:

[project.entry-points."opm.skill"]
hello-world-skill = "hello_world_skill:HelloWorldSkill"

Configuration

Key settings a skill can accept in its settings.json:

Both keys can also be set system-wide under the skills block in mycroft.conf.

Documentation

The OVOS Technical Manual is the canonical skill-authoring guide. Repo-local reference with exact source citations is in docs/:

• Skill classes
• OVOSSkill base class
• ask_yesno / ask_selection plugin system
• Decorators
• Settings
• Resource files
• Prerelease quirks — what changed since the last stable release

License

Apache 2.0