Skip to content
Back to search

botmaker

A Hermes Agent skill + SOUL for a bot whose only job is minting other specialist bots

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/techjanitor--botmaker/badge.svg)](/listings/techjanitor--botmaker)

HTML

<a href="/listings/techjanitor--botmaker"><img src="/api/listings/techjanitor--botmaker/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Installing botmaker is your first supervised run of its own method.

1. **Alias preflight** for the name `botmaker` (or whatever you call yours) — the two checks from `SKILL.md`:

   zsh -lc 'which -a botmaker'
   test -e "$HOME/.local/bin/botmaker" || test -L "$HOME/.local/bin/botmaker"

If either finds anything, create with `--no-alias`. (Why this matters: Hermes writes an alias wrapper into `~/.local/bin`, `Path.write_text()` follows symlinks, and that combination has overwritten a real installed CLI binary. The skill tells the whole story.)

2. **Copy the canonical skill tree** into the default Hermes home:

   cp -R skills/autonomous-ai-agents/botmaker ~/.hermes/skills/autonomous-ai-agents/botmaker

3. **Create the profile:**

   hermes profile create botmaker --no-skills --description "Designs, scaffolds, certifies, and documents specialist Hermes bots."

4. **Pin the brain** and clear any model block inherited from your default profile:

   hermes -p botmaker config set model.provider <provider>
   hermes -p botmaker config set model.default <model>
   hermes -p botmaker config unset model.base_url
   hermes -p botmaker config unset model.api_key
   hermes -p botmaker config get model   # must print only default + provider

5. **Install the SOUL.** Fill the `<placeholders>` in `profile/SOUL.md` (table below), then write it to `~/.hermes/profiles/botmaker/SOUL.md`. If you do this through the bot's own tools, Hermes will prompt you to approve the write — that prompt is the human gate working. Approve it yourself; don't disable it for interactive use. (Provisioning bots headless from kanban cards is the one scenario that needs the gate's tooling half off — see `profile/config.yaml` and the security note below.)

6. **Link the skill into the profile with its own linker** (file-level symlinks — a directory symlink is invisible to Hermes's skill discovery on Python 3.11):

   python3 ~/.hermes/skills/autonomous-ai-agents/botmaker/scripts/link_skill_tree.py \
     ~/.hermes/skills/autonomous-ai-agents/botmaker \
     ~/.hermes/profiles/botmaker/skills/autonomous-ai-agents/botmaker

7. **Smoke test.** Open the bot's chat and ask it to mint something deliberately fuzzy ("a bot to help with my projects"). It should refuse to scaffold and ask one sharp question. Give it a sharp job; it should stop at the sign-off gate with a one-screen draft.

8. **Drift tripwire.** `python3 ~/.hermes/skills/autonomous-ai-agents/botmaker/scripts/drift_check.py` should exit clean; run it after every mint and every doc patch. Point `BOTMAKER_VAULT_GUIDE` at your vault's `Bots/making-bots.md` to enable the roster-vs-profiles check. The design it enforces: every rule has one home — method in the skill tree, fleet state in the vault roster, history in the changelog.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 122 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # botmaker
  2. A [Hermes Agent](https://github.com/NousResearch/hermes-agent) skill + SOUL for a bot whose only job is minting other specialist bots.
  3. The loop it enforces:
  4. **interview → one-screen SOUL draft → human sign-off → scaffold (`--no-skills`, pinned brain, file-level skill links) → certification in the child's own chat → documentation in the vault**
  5. > Seeding files is not a bot.
  6. ## Why
  7. A SOUL.md dump on a cloned profile is a costume. A specialist has one job, a brain pinned off its own failure path, earned constraints, and a memory it wrote itself. Botmaker exists to make the second kind and refuse the first.
  8. ## What Hermes is
  9. [Hermes Agent](https://github.com/NousResearch/hermes-agent) is Nous Research's open-source agent framework: profiles (bots), skills, SOULs, persistent memory, bot-to-bot messaging. Docs: <https://hermes-agent.nousresearch.com>. This repo is a skill and a SOUL *for* Hermes, not a fork of it.
  10. ## What's in the repo
  11. ```
  12. profile/SOUL.md the botmaker SOUL — fill the <placeholders>, install per below
  13. profile/config.yaml example profile config — the headless-provisioning security flag, explained
  14. profile/profile.yaml example roster metadata — the one-liner other bots read, plus the UI title
  15. skills/autonomous-ai-agents/botmaker/
  16. ├── SKILL.md the runbook: interview, scaffold, certification, failure-mode index
  17. ├── references/soul-craft.md what goes in a SOUL, and the human gate
  18. ├── references/process.md independence pin, --no-skills, shared-skill mechanics, kanban intake
  19. ├── references/vault.md documenting the fleet (after certification, never before)
  20. ├── scripts/link_skill_tree.py file-level symlink linker for shared skills
  21. └── scripts/drift_check.py doc-drift tripwire — run after every mint
  22. ```
  23. The `skills/` subtree mirrors the canonical Hermes tree, so every path referenced inside the docs is true after install.
  24. ## Prerequisites
  25. - Hermes CLI with a working default profile (`hermes profile create --help` succeeds)
  26. - **At least two model providers configured.** The independence pin is the heart of the method: a bot that operates a service must not run on that service's inference path. If your fleet runs local inference, that means a hosted provider for the operators.
  27. - A documentation home for the fleet — any markdown directory works (Obsidian conventions shown in `references/vault.md`)
  28. - Optional: the [Honcho](https://hermes-agent.nousresearch.com/docs/user-guide/features/memory-providers) memory provider
  29. ## Install
  30. Installing botmaker is your first supervised run of its own method.
  31. 1. **Alias preflight** for the name `botmaker` (or whatever you call yours) — the two checks from `SKILL.md`:
  32. ```sh
  33. zsh -lc 'which -a botmaker'
  34. test -e "$HOME/.local/bin/botmaker" || test -L "$HOME/.local/bin/botmaker"
  35. ```
  36. If either finds anything, create with `--no-alias`. (Why this matters: Hermes writes an alias wrapper into `~/.local/bin`, `Path.write_text()` follows symlinks, and that combination has overwritten a real installed CLI binary. The skill tells the whole story.)
  37. 2. **Copy the canonical skill tree** into the default Hermes home:
  38. ```sh
  39. cp -R skills/autonomous-ai-agents/botmaker ~/.hermes/skills/autonomous-ai-agents/botmaker
  40. ```
  41. 3. **Create the profile:**
  42. ```sh
  43. hermes profile create botmaker --no-skills --description "Designs, scaffolds, certifies, and documents specialist Hermes bots."
  44. ```
  45. 4. **Pin the brain** and clear any model block inherited from your default profile:
  46. ```sh
  47. hermes -p botmaker config set model.provider <provider>
  48. hermes -p botmaker config set model.default <model>
  49. hermes -p botmaker config unset model.base_url
  50. hermes -p botmaker config unset model.api_key
  51. hermes -p botmaker config get model # must print only default + provider
  52. ```
  53. 5. **Install the SOUL.** Fill the `<placeholders>` in `profile/SOUL.md` (table below), then write it to `~/.hermes/profiles/botmaker/SOUL.md`. If you do this through the bot's own tools, Hermes will prompt you to approve the write — that prompt is the human gate working. Approve it yourself; don't disable it for interactive use. (Provisioning bots headless from kanban cards is the one scenario that needs the gate's tooling half off — see `profile/config.yaml` and the security note below.)
  54. 6. **Link the skill into the profile with its own linker** (file-level symlinks — a directory symlink is invisible to Hermes's skill discovery on Python 3.11):
  55. ```sh
  56. python3 ~/.hermes/skills/autonomous-ai-agents/botmaker/scripts/link_skill_tree.py \
  57. ~/.hermes/skills/autonomous-ai-agents/botmaker \
  58. ~/.hermes/profiles/botmaker/skills/autonomous-ai-agents/botmaker
  59. ```
  60. 7. **Smoke test.** Open the bot's chat and ask it to mint something deliberately fuzzy ("a bot to help with my projects"). It should refuse to scaffold and ask one sharp question. Give it a sharp job; it should stop at the sign-off gate with a one-screen draft.
  61. 8. **Drift tripwire.** `python3 ~/.hermes/skills/autonomous-ai-agents/botmaker/scripts/drift_check.py` should exit clean; run it after every mint and every doc patch. Point `BOTMAKER_VAULT_GUIDE` at your vault's `Bots/making-bots.md` to enable the roster-vs-profiles check. The design it enforces: every rule has one home — method in the skill tree, fleet state in the vault roster, history in the changelog.
  62. ## What to customize
  63. | Placeholder | Where | Meaning |
  64. |---|---|---|
  65. | `<model>` / `<provider>` | `profile/SOUL.md`, throughout the skill | The independence pin. Choose a provider that survives the failure your bots must outlive. |
  66. | `<your-vault-path>` | `references/vault.md`, SKILL.md prerequisites | Your fleet's documentation home. Any markdown directory works; Obsidian conventions are shown. |
  67. | `<peer>` / `<peer-url>` / `<keyfile>` | "site-specific" blocks in SKILL.md and process.md | Our external peer bridge, shown as a worked example. Adapt if your fleet has bot-to-bot peers outside Hermes; delete if not. |
  68. | `<review-skill>` | process.md | Placeholder for any skill your automation injects with `--skills`. |
  69. | Honcho sections | SKILL.md, process.md | Only if you use the Honcho memory provider; delete otherwise. |
  70. | `security.protected_instruction_files` | `profile/config.yaml` | `false` is what lets botmaker provision bots unattended from kanban cards; leave the default `true` if you run it interactively. See the security note below. |
  71. | `author:` frontmatter | SKILL.md | Make it yours once you've adapted the skill. |
  72. Other angle-bracket tokens (`<category>`, `<name>`, `<bot>`, `NAME`) are per-command values, the same convention the Hermes docs use.
  73. ## Field notes
  74. The pitfalls list in `SKILL.md` is earned, not hypothetical. Three of the scars, in brief:
  75. - **The alias clobber.** A profile that shared its name with an installed CLI overwrote the real 107MB binary through a `~/.local/bin` symlink. The preflight exists because the obvious check (`which`) is exactly the one that fails.
  76. - **The create leftover.** `profile create` copies the default profile's model block, so the freshly "independent" bot was silently still talking to the local GPU box. Hence the unset-and-verify step.
  77. - **The costume.** An operator bot shipped as "You are Grok" in a hat and had to be rewritten down to its job. Identity is the job name; voice inheritance is tone, not self.
  78. ## Security note
  79. Hermes protects agent-instruction files: writes to a profile's `SOUL.md` prompt the human by default (`security.protected_instruction_files: true`). That default is correct — the prompt is this method's human gate materialized in tooling.
  80. `profile/config.yaml` shows the one deliberate exception: botmaker's own profile runs with the flag set to `false`, because that is what allows it to provision bots from kanban cards unattended — a headless worker has no approval surface, so with the flag on, the child's `SOUL.md` write blocks on a prompt nobody can see, times out, and ships a stub. With the flag off, the signed spec on the kanban card becomes the only gate: no signature, no write. If you run botmaker interactively instead, leave the default alone — and never set the flag fleet-wide.
  81. ## License
  82. MIT — see [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.