mirror of
https://github.com/basicmachines-co/basic-memory
synced 2026-06-21 13:47:35 +00:00
phernandez
215a2d9f99
Adds the two deliberate-gesture skills from DESIGN.md Phase 2, both as prose skills (skills are prompts) — robust to arbitrary user text and any MCP server tool-name prefix, no bundled-script path placeholders. - skills/remember/SKILL.md → /basic-memory:remember <text>: quick capture to the rememberFolder (default bm-remember) with a first-line title and manual-capture tag, via write_note. Model-invocable so "remember that…" triggers it. - skills/status/SKILL.md → /basic-memory:status: user-only diagnostic (disable-model-invocation) reporting active project, capture/remember folders, output-style state, recent session checkpoints, and active-task count. validate_claude_plugin.py now requires the shipped skill set (REQUIRED_SKILLS) and validates each skill's name/description frontmatter. Passes `just package-check-claude-code` incl. `claude plugin validate . --strict`. Discovery verified end-to-end: installed from a local marketplace and confirmed via `claude plugin details` — Skills (2): remember, status; Hooks (2): SessionStart, PreCompact; Agents (0) — namespaced as /basic-memory:<name>. Updated README (Commands table), CHANGELOG, and DESIGN Phase 2 status. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Signed-off-by: phernandez <paul@basicmachines.co>
2.3 KiB
2.3 KiB
name, description, argument-hint
| name | description | argument-hint |
|---|---|---|
| remember | Quickly capture a thought, fact, or reminder into Basic Memory as a lightweight note. Use when the user says "remember that…", "note this", "save this to memory", or runs /basic-memory:remember. For quick deliberate capture — not full decision or session records. | <text to remember> |
Remember
Capture $ARGUMENTS into Basic Memory as a quick note, keeping the user's words.
Steps
-
Resolve config. Read
.claude/settings.json(and.claude/settings.local.jsonif it exists) and look for thebasicMemoryblock:rememberFolder— folder for quick captures (default:bm-remember)primaryProject— project to write to (default: omit theprojectargument so Basic Memory uses its default project)
Both are optional. Use the defaults if the block or a key is missing. Don't fail if there's no settings file.
-
Derive the note.
- Content = the text in
$ARGUMENTS, verbatim. Don't rewrite or pad it. - Title = the first line of that text, trimmed to ≤ 80 characters (append
…if you truncate). If it's one long line, write a short descriptive title instead. - If
$ARGUMENTSis empty (e.g. you were invoked because the user said "remember that…"), capture the specific thing they asked you to remember from the conversation. If it's genuinely unclear what to save, ask one short question.
- Content = the text in
-
Write it with
write_note:title= the derived titledirectory= the resolvedrememberFoldercontent= the texttags=["manual-capture"]project=primaryProjectif set; otherwise omit it Don't overwrite an existing note unless the user explicitly asks.
-
Confirm in one line: what was saved and its permalink — e.g.
Saved → bm-remember/<slug>.
Notes
- This is a quick capture. Keep the user's wording; don't add observations, relations, or structure unless they ask.
- For a decision with rationale and alternatives, write a
type: decisionnote instead (the basic-memory output style covers this). Wrapping up a work session is the PreCompact checkpoint's job, not this skill's. - Use whichever Basic Memory MCP server is connected — don't assume a specific tool name prefix.