Capture a fact, person, event, or piece of knowledge into the Minions vault. Two modes: quick (instant inbox drop, default) or direct (immediate extraction + placement). USE when: /minions-remember, remember [fact], save this, store this, note this, capture this, log this, add to vault, add to brain, jot down, track this. Also triggers on declarative knowledge drops: 'X got promoted', 'met X at Y', 'X joined/left', 'X said that', 'FYI [fact]', 'heads up [fact]', 'quick note:', 'update on X'. Source captures: 'from this article', 'key point from meeting', '--source'. DO NOT use for task reminders ('remember to do X', 'don't forget to') — those are todos, not knowledge. DO NOT use for session analysis ('what did I work on') — use /minions-learn instead.
Two modes: quick capture (default) dumps to _Inbox/ for zero-friction storage. Direct mode (--direct) runs full extraction + dedup + placement. Either way, facts are always appended to the daily journal.
SKILL_DIR = directory containing this SKILL.md
SHARED_DIR = {SKILL_DIR}/../_shared
CONVENTIONS = {SHARED_DIR}/vault-conventions.md
EXTRACT_REF = {SKILL_DIR}/references/extraction-guide.md
Read CONVENTIONS and EXTRACT_REF at the start of every run. They define file formats, wikilink prefixes, and extraction quality rules.
Read _Meta/state.json from the brain directory to get brain_dir. Default: ~/brain.
BRAIN_DIR = state.json → brain_dir (or ~/brain)
Verify BRAIN_DIR exists. If not, abort with: "No vault found. Run /minions-init first."
Read _Meta/preferences.json → PREFS. Respect throughout:
PREFS.naming when creating entity files (file_case, date_prefix, entity_file_pattern)PREFS.structure.protected_folders — never create files inside thesePREFS.agent_permissions — check before writing to any folderPREFS.content.wikilink_prefixes — when inserting [[links]] in facts| Invocation | Capture Mode | Action |
|---|---|---|
/minions-remember "text" | quick (default) | Dump to _Inbox/ + journal |
/minions-remember "text" --direct | direct | Full extract + dedup + place |
/minions-remember "text" --domain work | quick + domain | Dump with domain tag |
/minions-remember "text" --source "Paper Title" | direct + source | Extract with provenance tracking |
/minions-remember --sessions | direct | Scan recent sessions, extract facts |
/minions-remember | quick | Ask user: "What should I remember?" |
--source)When --source is provided, always runs in direct mode and additionally:
Sources/ (type: source) if it doesn't existextracted_from relationship(source: [[&Source Name]]) to every extracted factcites/extends/introduces relationships where detectableQuick mode (default): zero classification, zero LLM calls, zero dedup. Just capture and move on. /minions-organize processes the inbox later.
Direct mode (--direct): full extraction + Mem0-style dedup + immediate entity file placement. Use when you know exactly what you're storing.
Domain defaults to general. Accept any string.
If mode == quick:
→ Go to Step Q (Quick Capture) — skip Steps 1-5 entirely
If mode == direct:
→ Go to Step 1 (full pipeline)
Fast path. No LLM, no classification, no dedup. ~2 seconds total.
Create {BRAIN_DIR}/_Inbox/{YYYY-MM-DD}-{HHMM}.md:
---