Skip to content
Back to search

spellbook-herdr

SkillWorks with Claude CodeGitHub

Spellbook as a Herdr layout: write agent skills with Claude Code beside you

Safety scan

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

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/getmurmur--spellbook-herdr/badge.svg)](/listings/getmurmur--spellbook-herdr)

HTML

<a href="/listings/getmurmur--spellbook-herdr"><img src="/api/listings/getmurmur--spellbook-herdr/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.

Needs Herdr, and Claude Code on your PATH.

git clone https://github.com/getmurmur/spellbook-herdr && cd spellbook-herdr
sh scripts/link.sh

Then switch layouts with `ctrl-shift-l`. Your own layout stays as it was.

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 · 67 lines
  1. # Spellbook for Herdr
  2. ![Spellbook for Herdr](preview.png)
  3. [Spellbook](https://spellbook.getmurmur.dev) as a [Herdr](https://herdr.dev) layout: write agent skills with Claude Code beside you, in Herdr's window.
  4. - **Skills** on the left: your drafts in `~/Skills`, newest first. Each one says whether it's installed in Claude Code, or changed since it was. A dot shows when its agent is working or needs you.
  5. - **The skill** in the middle: name and description fields bound to the frontmatter, the body in an editor, Spellbook's lint as you type, and autosave. When the agent edits `SKILL.md`, the change shows up at once, with Revert.
  6. - **The agent** on the right: Claude Code, started in the skill's folder with Spellbook's writing prompt. Each skill is a Herdr space, so its agent and conversation stay where you left them.
  7. - **New skill** takes a name and, if you like, a sentence about what it should do. That sentence becomes Claude's first message.
  8. - **Install in Claude Code** copies the draft to `~/.claude/skills/<name>`. It asks first if the installed copy is different.
  9. ## Install
  10. Needs Herdr, and Claude Code on your PATH.
  11. ```sh
  12. git clone https://github.com/getmurmur/spellbook-herdr && cd spellbook-herdr
  13. sh scripts/link.sh
  14. ```
  15. Then switch layouts with `ctrl-shift-l`. Your own layout stays as it was.
  16. ## Settings
  17. `~/.config/herdr-app/spellbook.json`, all optional:
  18. ```json
  19. {
  20. "root": "~/Skills",
  21. "claude": "~/.claude/skills",
  22. "agent": ["claude"],
  23. "font": "Geist"
  24. }
  25. ```
  26. `root` is where your drafts live (the same folder as the Spellbook app's), `claude` is where Install copies to, `agent` is the command each skill's space starts (Spellbook's prompt is added only for `claude`), and `font` is the editor's.
  27. ## Develop
  28. The lint and frontmatter code is Spellbook's, in TypeScript under `src/core`, bundled into `mods/spellbook/core.js`. That file is committed, so the mod runs straight from a clone.
  29. ```sh
  30. bun install
  31. bun test
  32. bun run typecheck
  33. bun run build # after changing src/core
  34. herdr-app check mods/spellbook # Herdr's own check
  35. ```
  36. Herdr doesn't hot-reload a linked mod: switch to another layout and back to load your changes.
  37. To try it without touching your own spaces, run a separate Herdr with its own home and core:
  38. ```sh
  39. HERDR_APP_HOME=/tmp/sb/home HC_SESSION=spellbook-test herdr-app
  40. ```
  41. ## Not yet
  42. - Diff review: an outside change can be reverted as a whole, not chunk by chunk.
  43. - Renaming a skill from the name field (the folder keeps its name).
  44. - Files other than `SKILL.md` in the editor, Evals, Share, Publish, Codex and project installs.
  45. ## Licence
  46. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

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