Skip to content

Garry's Opinionated OpenClaw/Hermes Agent Brain

TypeScript

docs: name Cursor pinned skills in the skill resolver guide

garrytandc027d7aaae9
diff --git a/changelog.d/capy-gbra435-pr3-cursor-pins.md b/changelog.d/capy-gbra435-pr3-cursor-pins.md
index 034d5cbfea..fd8c6e79a9 100644
--- a/changelog.d/capy-gbra435-pr3-cursor-pins.md
+++ b/changelog.d/capy-gbra435-pr3-cursor-pins.md
@@ -5,5 +5,5 @@
- Setup builds a catalog for the project from the skill folders Cursor loads there (`.agents`, `.cursor`, `.claude` and `.codex` skills in the project and your home directory) and prints its name. `gbrain skills pin add <id> --catalog <name>` checks the id against that catalog.
- The pins go in their own always-applied rule, `.cursor/rules/gbrain-pinned-skills.mdc`, with each skill's SKILL.md path. In a git repository its path goes in `.git/info/exclude`, so it is never committed. Your own rules are never touched, and with no pins there is no file.
- `gbrain doctor` reports Cursor as partial: pinned only, no per-turn hook, unverified. Nothing on this machine can see Cursor's request to confirm the rule reaches the model.
-- The pins sit beside the skills index that `--skill-loading spring` writes into gbrain's brain-first rule: on Cursor, resolve leaves that index in place, and `--skill-loading spring` no longer removes the pinned-skills rule.
+- The pins sit beside the skills index that `--skill-loading spring` writes into gbrain's brain-first rule: on Cursor, resolve leaves that index in place, and `--skill-loading spring` leaves the pinned-skills rule in place.
- `gbrain setup cursor --skill-loading off` removes the rule and its exclude line; the pins stay in config.json. Nothing opens a brain, so a keyless or brainless install stays as it is.
diff --git a/docs/guides/skill-resolver.md b/docs/guides/skill-resolver.md
index 2405405a84..254c44e853 100644
--- a/docs/guides/skill-resolver.md
+++ b/docs/guides/skill-resolver.md
@@ -10,7 +10,8 @@ model.
- **Off by default.** Nothing changes until you build a catalog and wire a
harness to call `gbrain skills resolve`, or turn on the hook lane with
`gbrain setup <claude-code|codex|hermes> --skill-loading resolve` (OpenClaw and
- Pi: the plugin and extension below). Setup writes nothing for it otherwise.
+ Pi: the plugin and extension below; Cursor: pinned skills only, below).
+ Setup writes nothing for it otherwise.
- **Local and deterministic.** Word matching (BM25F) over the catalog's names,
descriptions, triggers, routing rows and the first 4 KB of each body. No
network, no model, no clock, no randomness on the turn path.
@@ -41,7 +42,7 @@ One catalog per skill set. Names are 1-64 characters of `a-z`, `0-9`, `_` and
| Claude Code plugins | `gbrain skills index build --catalog claude-code-plugins --claude-plugins ~/.claude --harness claude-code` | The enabled user-scope plugins (`enabledPlugins` in `settings.json`, install paths from `plugins/installed_plugins.json`), each skill as `<plugin>:<skill>`. |
| Codex | `gbrain skills index build --catalog codex-user --dir ~/.codex/skills --harness codex` | Suggestion lines carry the SKILL.md path; Codex opens it. |
| Hermes, qm | `--dir <skills dir> --harness hermes` (or `qm`) | The id is the name the loader takes. |
-| Pi, Cursor | `--dir <skills dir> --harness pi` (or `cursor`) | Suggestion lines carry the SKILL.md path; the agent reads the file. For Pi, `gbrain setup pi --skill-loading resolve` builds `pi-user` for you (see below). |
+| Pi, Cursor | `--dir <skills dir> --harness pi` (or `cursor`) | Suggestion lines carry the SKILL.md path; the agent reads the file. For Pi, `gbrain setup pi --skill-loading resolve` builds `pi-user` for you (see below); for Cursor, `gbrain setup cursor --skill-loading resolve` builds the project's `cursor-project-<16 hex>` catalog for pinned skills. |
| OpenClaw | `openclaw skills list --json \| gbrain skills index build --catalog openclaw-main --from-json - --dir <skills dir> --harness openclaw` | The list builds as is: the name is the id, and a skill OpenClaw hides from the model is skipped as ineligible. Each listed skill takes its body, path and triggers from the `--dir` skill of the same name; folder-only skills stay out. |
| Other adapters | `gbrain skills index build --catalog <name> --from-json - --harness <h>` | The adapter pipes its skill list (schema below) and owns rebuilds. |
| gbrain's own skills | `gbrain skills index build --catalog gbrain --bundled` | Rebuilt when the gbrain version changes. |