Botmaker
techjanitor/botmaker
Hermes Agent skill and SOUL for a bot whose only job is creating other specialist bots
Botmaker is a Hermes Agent skill plus a SOUL.md for a dedicated profile that designs, scaffolds, certifies and documents other specialist Hermes bots. It enforces a supervised loop with a human sign-off before any new bot is created.
What Botmaker does
Botmaker enforces one loop: interview, a one-screen SOUL draft, human sign-off, scaffold, certification in the new bot's own chat, and documentation in a vault. Scaffolding uses --no-skills, a pinned model for the new bot and file-level skill links. The README's position is that seeding files is not a bot. A SOUL.md dropped onto a cloned profile is a costume, while a specialist has one job, a brain pinned off its own failure path, earned constraints and a memory it wrote itself.
The repository holds a SOUL.md plus example config.yaml and profile.yaml for the botmaker profile, and a skill tree with a SKILL.md runbook. Reference documents cover SOUL craft, process and vault documentation. Two scripts are included: link_skill_tree.py links shared skills through symlinks, and drift_check.py checks for documentation drift after every new bot. It is a skill and SOUL for Hermes, not a fork of it.
Key features
- Interview-to-SOUL workflow with a human sign-off gate
- Scaffolds new profiles with --no-skills and a pinned model provider
- Certification step in the new bot's own chat
- link_skill_tree.py links shared skills at file level
- drift_check.py checks for documentation drift after each new bot
- Alias preflight checks before a profile is created
When to use it
- Creating several single-purpose Hermes profiles with a consistent setup
- Keeping documentation of each bot in a markdown vault
- Making sure an operator bot does not run on the inference path of the service it operates
Who it is for: Hermes Agent operators who run several specialist profiles and want a repeatable, supervised way to create them.
How it fits with Hermes Agent
Built for Hermes Agent as a skill and SOUL, using Hermes profiles, skills, SOULs and the hermes profile create command.
How to install Botmaker
These commands are copied from the project's README. Check the repository for the latest steps before you run them.
cp -R skills/autonomous-ai-agents/botmaker ~/.hermes/skills/autonomous-ai-agents/botmaker
hermes profile create botmaker --no-skills --description "Designs, scaffolds, certifies, and documents specialist Hermes bots."Requirements: Hermes CLI with a working default profile, at least two configured model providers, and a markdown directory for fleet documentation
FAQ
What is Botmaker?
Botmaker is a Hermes Agent skill and SOUL for a bot whose only job is minting other specialist bots. It runs an interview, drafts a SOUL, waits for human sign-off, scaffolds the profile, certifies it and documents it.
What do I need to run Botmaker?
You need a Hermes CLI with a working default profile and at least two model providers configured. You also need a markdown directory to document the fleet, and the Honcho memory provider is optional.
Why does Botmaker need two model providers?
The README says a bot that operates a service must not run on that service's inference path. If your fleet runs local inference, that means using a hosted provider for the operator bots.
Similar skills for Hermes Agent
All skillsPersona library that makes an AI write in the voice of named characters, installable as a Hermes skill
alchaincyf Feynman SkillAgent skill that applies Richard Feynman's mental models, such as cargo cult detection, to your questions
tonbistudio Buzz SkillsHermes Agent skills for connecting a Hermes gateway to a Buzz community and sending media attachments
AkoliteZA Hermes Agent Idea WorkflowSkills that turn a rough product idea into a design doc, implementation spec and build handoff
tlehman litprog-skillLiterate programming skill that turns a codebase into a .lit.md document and tangles source back out
DavidBB-L Cinema ManagerHermes skill that searches movie and TV sources, saves to Quark cloud drive and organizes the library
Related guides: What is Hermes Agent? · SOUL.md for Hermes Agent: what it is and how to write one