Brooklyn's skills
Portable SKILL.md packages for coding agents. There are no harness-specific
commands, hooks, adapters, or setup scripts.
Use
Give your agent this repository:
https://github.com/OutThisLife/brooklyn-skillsThen 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/skillsExample prompts
Just 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 PUTsChaining 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.
Always-on defaults
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.
Contents
skills/— portableSKILL.mdpackages, invoked on demanddefaults.md— always-on baseline behaviors
No commands, hooks, editor settings, secrets, or machine state are included.
Related workflows
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.