Buzz and Hermes Skills
Three skills for Hermes Agent: joining a Buzz community, sending media as attachments and running a self-hosted Buzz relay.
- 278 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The skills touch agent and owner keys, configure a gateway and write to the Hermes profile `.env`.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/buzz-and-hermes-skillsDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The skills touch agent and owner keys, configure a gateway and write to the Hermes profile `.env`.
This is third-party code. Review the repository files before installing.
What it does
Buzz and Hermes Skills bundles three skills for Hermes Agent running as a native Buzz messaging agent. `hermes-in-buzz` guides setup and troubleshooting: a separate Nostr identity, owner-only access, Buzz CLI installation, gateway configuration and live inbound and outbound verification. `buzz-media-attachments` sends local files to the active chat with `buzz messages send --file`; for MP4 files the relay rejects it repairs the file by remux or re-encode and, when needed, makes a GIF. `buzz-self-hosting` helps stand up a self-hosted relay from the `deploy/compose` stack and debug common failures. The `update_buzz_credentials.py` script updates keys through hidden input.
Who it is for. Hermes Agent owners who connect an agent to a Buzz community or run their own Buzz relay.
Good fit when
- A remote Hermes gateway must join a Buzz community as a separate agent with its own key.
- A video clip fails to attach because the relay rejects the MP4.
- A self-hosted Buzz relay is stood up via `deploy/compose` and you need to find where the agent stops answering.
- Agent keys must be rotated without exposing them in command-line arguments.
Not a fit when
- You do not use Hermes: the skills are written for it.
- You need another messenger, not Buzz.
- Standard `MEDIA:/path` delivery already works reliably for attachments.
Example request
Use the hermes-in-buzz skill to connect this Hermes host to my Buzz community and verify messaging in both directions.Limitations
It needs Hermes Agent with gateway support, a Buzz relay URL and a dedicated agent identity. Sending messages needs the external `buzz` CLI, video inspection needs FFmpeg and FFprobe, and building the Rust helper may need Cargo. The `hermes-in-buzz` skill treats official Hermes documentation and the latest `block/buzz` release as authoritative over its own text. Hermes can modify a skill in place when the directory is writable, so restrict it with filesystem permissions.
How to disable. Remove the path from `skills.external_dirs` in `~/.hermes/config.yaml` or delete the copied directories from `~/.hermes/skills/` and start a new Hermes session. Disconnect the gateway from Buzz in the gateway settings.
FAQ
Which access defaults are safe?
The recommended defaults are `allow_all_users: false`, an explicit owner allowlist and `require_mention: true`. Open access to everyone is better left off.
Can the owner's key be used for the agent?
No. The README requires a dedicated agent identity and forbids reusing a human owner's `nsec`.
How does the skill confirm the connection works?
Process state alone is not enough. A real relay or CLI result and a live inbound and outbound Buzz exchange are required.
How should an `.env` with the auth tag be loaded?
With a dotenv parser rather than the shell: `BUZZ_AUTH_TAG` may hold JSON that shell parsing corrupts.
What tools do attachments need?
The external `buzz` CLI for sending, plus FFmpeg and FFprobe to inspect and repair MP4 files and, if needed, make GIFs.
Discussion
No questions or reviews yet.
Related
SkillsA gateway plugin that connects Hermes Agent to the MAX messenger: voice transcription, buttons, table-to-image rendering and cross-platform sessions
hermes-vk (TemArt90)
hermes-vk
A VK channel for Hermes Agent: Long Poll, buttons and model choice in the dialog, voice, images, cron report delivery and pairing approval
A VKontakte plugin for Hermes Agent: a community bot receives direct and group messages over Long Poll API and the agent replies as the community
Hermes VK Adapter
hermes-vk-adapter
A plugin that connects VK community private messages to Hermes Agent through Bots Long Poll with no public address or webhook
AI Agent Skills by sanjay3290
AI Agent Skills
Cross-platform agent skills: read-only PostgreSQL, MySQL and MSSQL queries, Google Workspace, Jira, Telegram, text-to-speech and research
Hark sends iPhone notifications from agents and scripts, asks you to approve risky commands and shows task progress
README in short
Three skills, install options (external directory or copy), connection flow, security principles and requirements.