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.mdindex 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.mdindex 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 aharness 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. Nonetwork, 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. |