Portable SKILL.md packages for coding agents. There are no harness-specific
commands, hooks, adapters, or setup scripts.
Give your agent this repository:
https://github.com/OutThisLife/brooklyn-skills
Then ask it to install one skill, a few named skills, or all of them in the location its harness expects. For example:
Install the pr-triage and pr-ready skills from this repository.
The agent should copy each requested skills/<name>/ directory as a complete
unit so references and bundled resources remain intact.
On Hermes Agent you can skip
copying entirely — clone the repo and point at it, so git pull is the update
path and every skill shows up as a slash command:
# ~/.hermes/config.yaml
skills:
external_dirs:
- ~/path/to/brooklyn-skills/skillsJust name the skill in the sentence. The description in each SKILL.md is what
the agent matches against, so /clean, clean, and "clean it up" all land on
the same skill. The leading slash is only shorthand — nothing here depends on
your agent supporting slash commands.
lets /work on the retry backoff for the upload queue
please /clean your work and then /pr-update
/cpr — same thing in one pass, ends on the PR link
/pr-ready — CI is red and Copilot left three threads
/audit-only: why does the session cache miss on cold start?
/ui-only while we get the settings panel looking right, then /visual-verify
/research whether anyone solves partial-file uploads with resumable PUTs
Chaining them in one message is the normal case: the first skill does the work
and the later ones pick up its output. A few pair up so often that defaults.md
runs them without being asked — clean before any PR handoff, no-tropes on
prose.
defaults.md is a small set of baseline behaviors meant to be always loaded,
not invoked. It's harness-agnostic: append it to ~/.hermes/SOUL.md
(Hermes Agent), your AGENTS.md
(Claude Code, Codex, and most other agents), or ~/.cursor/rules/defaults.mdc
(Cursor, with alwaysApply: true). The skills handle the deeper workflows it
points to.
skills/— portableSKILL.mdpackages, invoked on demanddefaults.md— always-on baseline behaviors
No commands, hooks, editor settings, secrets, or machine state are included.
Personal setup notes (git worktree cleanup, scheduled prune, disk tips) live in the BB Workflows gist:
| File | Contents |
|---|---|
| main.md | Index |
| general.md | git-gtr + shared cleanup (cross-platform) |
| mac.md | macOS install, zsh helper, LaunchAgent |
| windows.md | Windows 11 install, Task Scheduler |
MIT licensed.