__init__.py

import logging

from opsdroid.matchers import match_regex
from opsdroid.skill import Skill


class Helper(Skill):
    @match_regex(r"help$")
    async def help(self, message):
        """help - Displays this help message"""
        response = []
        for skill in self.opsdroid.skills:
            if skill.__doc__:
                response.append("{}: {}".format(skill.__name__, skill.__doc__))
            else:
                doc_string_not_found = "doc string not found for {}".format(
                    skill.__name__
                )
                logging.debug(doc_string_not_found)
                response.append(skill.__name__)
        await message.respond("\n".join(sorted(response)))

    @match_regex(r"help (.*)")
    async def help_skill(self, message):
        """help <skill_name> - Displays usage for provided skill"""
        logging.debug("searching for {}".format(message.regex))
        found_skill = next(
            (
                skill
                for skill in self.opsdroid.skills
                if skill.__name__ == message.regex.group(1)
            ),
            False,
        )
        if not found_skill:
            response = "{} skill not found".format(message.regex.group(1))
        elif not found_skill.__doc__:
            response = "No usage found for {}".format(found_skill.__name__)
        else:
            response = found_skill.__doc__
        await message.respond(response)