feat(plugins): setup installs the shared memory-* skills (no repo dup)

Addresses the consolidation direction from issue #866: the Claude Code plugin
should consume the canonical skills/ set, not reinvent a parallel one. Rather
than vendoring copies into the plugin, /basic-memory:setup now offers to install
the shared memory-* skills via `npx skills add basicmachines-co/basic-memory
--path skills` (the existing SPEC-58 distribution path, same source OpenClaw
bundles). The plugin stays "hooks + Claude-Code-specific skills" and pulls the
shared toolkit on demand — skills/ remains the single source of truth, no
duplication in the repo.

Updated the setup interview + apply steps, README, getting-started, and CHANGELOG.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: phernandez <paul@basicmachines.co>
This commit is contained in:
phernandez
2026-05-28 22:16:31 -05:00
committed by Paul Hernandez
parent df3eb3208c
commit fc8ac86fa1
4 changed files with 28 additions and 4 deletions
+5 -2
View File
@@ -23,8 +23,11 @@ Memory's durable graph**, rather than a memory layer of its own. See
- **`/basic-memory:setup`** (`skills/setup/`) — a short guided interview that
configures the project for the plugin: maps it to a Basic Memory project (picking
an existing one or creating a new one), seeds the `session`/`decision`/`task`
schemas into the project, optionally learns the project's placement conventions,
and enables the capture reflexes. Writes the `basicMemory` block to
schemas into the project, installs the shared `memory-*` skills via
`npx skills add basicmachines-co/basic-memory --path skills` (the plugin doesn't
vendor its own copies — `skills/` is the single source of truth, shared with
OpenClaw), optionally learns the project's placement conventions, and enables the
capture reflexes. Writes the `basicMemory` block to
`.claude/settings.json` (or `settings.local.json`). The SessionStart hook nudges
toward this on first run; running it (writing the config) stops the nudge. (Phase 3)
- **`/basic-memory:remember <text>`** (`skills/remember/`) — quick deliberate
+1 -1
View File
@@ -38,7 +38,7 @@ Plugin skills are namespaced under the plugin name:
| Command | What it does |
|---------|--------------|
| `/basic-memory:setup` | One-time guided setup — maps the project to a Basic Memory project, seeds the note schemas, optionally learns your conventions, and turns on the capture reflexes. Run this first. |
| `/basic-memory:setup` | One-time guided setup — maps the project to a Basic Memory project, seeds the note schemas, installs the shared `memory-*` skills, optionally learns your conventions, and turns on the capture reflexes. Run this first. |
| `/basic-memory:remember <text>` | Quick capture — saves the text to the `bm-remember` folder with a `manual-capture` tag. Also fires when you say "remember that…". |
| `/basic-memory:share <note>` | Promote a personal note to a configured team project, with attribution and confirmation. The deliberate way to write to a shared workspace. |
| `/basic-memory:status` | Diagnostic — shows the active project, team read-sources and share targets, capture folders, output-style state, recent session checkpoints, and active-task count. |
@@ -44,6 +44,8 @@ It's a short interview. It will:
- map this project to a Basic Memory project (pick an existing one or create a new one),
- seed the `session` / `decision` / `task` schemas so notes are findable by structured
search,
- install the shared `memory-*` skills (`npx skills add …`) — the plugin ships only the
Claude-Code-specific glue and pulls the canonical skills on demand,
- optionally learn your existing folder/naming conventions,
- enable the capture reflexes (output style),
- write a `basicMemory` block to `.claude/settings.json`.
+20 -1
View File
@@ -75,6 +75,13 @@ Ask only what you can't infer. Cover:
capture decisions as typed notes, cite permalinks)" → sets
`outputStyle: "basic-memory"`. Default yes for standard/heavy, ask for light.
8. **Shared skills** (optional, default yes). "Want the full Basic Memory toolkit —
the shared `memory-*` skills (`memory-notes`, `memory-tasks`, `memory-research`,
`memory-schema`, `memory-defrag`, …)? I can install them alongside this plugin."
These are the canonical, framework-agnostic skills (the same set OpenClaw bundles).
This plugin ships only the Claude-Code-specific glue and pulls the shared set on
demand — it doesn't vendor its own copies. (See "Install the shared skills" below.)
## Apply (after confirming the plan)
### 1. Seed the schemas
@@ -93,7 +100,19 @@ For each one:
note's frontmatter, so the `type: schema` + `entity` + `schema` definition land
intact and become resolvable by `schema_validate`), `project` = `primaryProject`.
### 2. Write settings
### 2. Install the shared skills (if the user opted in)
Run, from the project root:
```
npx skills add basicmachines-co/basic-memory --path skills
```
This installs the canonical `memory-*` skills into the user's skills directory — the
single source of truth, shared with OpenClaw. The plugin does **not** vendor copies;
it relies on this shared set. If `npx` / the `skills` CLI isn't available, point the
user at the manual install in the top-level [`skills/README.md`](../../../../skills/README.md).
### 3. Write settings
Build the `basicMemory` block from the interview:
```json