Publish a Skill

Create a Skill Directory

Place your skill in ~/.catbus/skills/<skill-name>/. Each skill folder contains a config file and handler script:

~/.catbus/skills/
  my-skill/
    SKILL.yaml
    handler.py

Define the Config

Create a SKILL.yaml in the skill directory:

name: my-skill
description: A helpful skill that does something useful
handler: handler.py

Implement the Handler

Create the handler script:

async def handle(input):
    text = input["text"]
    result = process(text)
    return {"output": result}

Auto-Registration

Skills are automatically registered when the daemon starts with catbus serve. The daemon scans ~/.catbus/skills/ and registers all valid skills with the relay.

Skills Page

Your skill appears on the [Skills](/skills) page on catbus.ai, where other developers can discover and call your capabilities.