Buzz Skills: skill pack for Hermes Agent

Hermes Agent skills for connecting a Hermes gateway to a Buzz community and sending media attachments

What Buzz Skills does

The repository contains three skills. hermes-in-buzz covers end-to-end setup and troubleshooting for a dedicated Hermes Agent running as a native Buzz messaging agent, including relay connectivity, a separate Nostr identity, owner-only access controls, Buzz CLI installation, NIP-OA attestation, gateway configuration and live inbound and outbound checks. buzz-media-attachments sends local files through the native buzz messages send --file flow when generic MEDIA:/path delivery is unavailable or unreliable, with MP4 fast-start and sanitization workflows plus a GIF fallback.

buzz-self-hosting guides an agent helping a user run and debug a self-hosted Buzz relay from the deploy/compose stack. It covers secrets, closed-relay membership, the localhost versus 127.0.0.1 404 trap, Windows and Git Bash pitfalls, backups and the limits of moving from hosted to self-hosted. A cross-platform script, update_buzz_credentials.py, reads keys with hidden input and updates the active profile's .env without taking secrets as command-line arguments. An optional Rust helper derives a public agent identity and creates owner attestations.

Key features

hermes-in-buzz skill for setting up Hermes as a native Buzz messaging agent
buzz-media-attachments skill that sends local media with buzz messages send --file
buzz-self-hosting skill for running and debugging a self-hosted Buzz relay
update_buzz_credentials.py updates the profile .env without secrets in command-line arguments
Optional Rust helper for deriving a public agent identity and NIP-OA attestations
Works as an external skills directory registered in ~/.hermes/config.yaml

When to use it

Connecting a remote Hermes gateway to a Buzz community
Sending a generated video or image to a Buzz conversation as a native attachment
Standing up and debugging a self-hosted Buzz relay with agent help

Who it is for: Hermes Agent operators who use or host Buzz and want their agent to join it as a messaging channel.

How it fits with Hermes Agent

Built for Hermes Agent: all three are Hermes skills that go into ~/.hermes/skills or an external skills directory set in the Hermes config.

How to install Buzz Skills

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

git clone https://github.com/tonbistudio/buzz-skills.git
cp -R buzz-skills/hermes-in-buzz buzz-skills/buzz-media-attachments buzz-skills/buzz-self-hosting ~/.hermes/skills/

FAQ

What is Buzz Skills?

Buzz Skills is a collection of three Hermes Agent skills for working with Buzz. They cover connecting Hermes to a Buzz community, sending media as native attachments and self-hosting a Buzz relay.

How do I install Buzz Skills?

Clone the repository and copy the skill folders into ~/.hermes/skills, then start a new Hermes session. Alternatively, register the checkout under skills.external_dirs in ~/.hermes/config.yaml so it can be updated with git pull.

Is Buzz Skills free and open source?

Yes, the repository is licensed under MIT.