Memorb (Gateway Skill)
CRITICAL: Primary routing hub for the vault. Every file operation must strictly follow these instructions and sub-skill routing without exception.
Instruction Priority
- Explicit User Instructions (highest)
- Memorb & Routed Sub-skills (overrides default agent behavior)
- Default Agent Behavior (lowest)
Core Rules
Before performing any file operation:
- Read this gateway file.
- Read
SKILL.md for every matching sub-skill in the routing table below.
- All write operations must adhere to
memorb-conventions (paths, naming, frontmatter).
- Load multiple sub-skills if needed (e.g., transcript processing =
recording-transcription + memorb-ingest).
Ownership boundary
memOrb may read anything the user points it at; it writes only inside memorbs/. No exceptions — this binds extensions too.
Reading is safe: no state change, no surprise. Conditional writing is where the trouble lives. The moment a skill says "write to the reference folder if it exists", the same operation produces three different outcomes depending on a coincidence of folder naming — it writes for one user, silently skips for the user who numbered their folders, and does nothing for the user who has none. That is worse than either owning the folder or never touching it.
So memOrb grows exactly one folder in the user's vault: memorbs/. Delete it and the vault is clean.
Skill Router Table
Core skills reside in skills/core/{name}/SKILL.md.
Extensions reside in skills/extensions/{name}/SKILL.md.
Core Skills (memorb-core)
| Sub-skill |
Location |
Trigger / Scenario |
| memorb-conventions |
core/memorb-conventions |
Base layer: paths, directory structure (memorbs/), naming, frontmatter, templates. Required for ALL write ops. |
| memorb-born |
core/memorb-born |
Vault initialization (Phase 0), persona seed setup, CLAUDE.md generation, or /memorb-born reset. |
| orbtrack-triage |
core/orbtrack-triage |
Ingest Pass 2: Impact Scan on Long-Term entity pages, PARA organization, and zero-leftover triage of memorbs/HQ/OrbTrack/. |
| island-reclamation |
core/island-reclamation |
Create new Island (long-term interest/responsibility domain): discuss structure before file creation |
| dream-studio |
core/dream-studio |
Monthly memory replay: propose Core orbs, add/revise Belief orbs, refresh Island narrative. Sole writer of memorbs/HQ/Core/. |
| memorb-ingest |
core/memorb-ingest |
Ingest Pass 1: Auto-capture conversation stories/experiences or distill raw files (PDFs, transcripts) into atomic notes in memorbs/HQ/OrbTrack/. |
| memorb-query |
core/memorb-query |
Q&A, comparisons, decision recommendations via memorbs/Long-Term/／memorbs/ wiki |
| memorb-lint |
core/memorb-lint |
Vault health check and memorbs/Long-Term/／memorbs/ wiki MUSTY linting |
| memorb-forgetter |
core/memorb-forgetter |
Execute MUSTY archiving to memorbs/Dump/ and update vault Wiki Links |
| writing-memorb-skills |
core/writing-memorb-skills |
Create/modify vault skills (Meta) |
Extension Skills (memorb-extensions)
| Sub-skill |
Location |
Trigger / Scenario |
| recording-transcription |
extensions/recording-transcription |
Non-Teams voice recordings (phone, interview, m4a) to transcript |
| business-card-ingestion |
extensions/business-card-ingestion |
Business cards to memorbs/Long-Term/People/ entity notes |
| memorb-domain-query |
extensions/memorb-domain-query |
Bi-directional domain/email lookup & M365/Outlook integration |
Extension Interactive Installation & Fallback Protocol
If a scenario calls for an extension (e.g. business card OCR, M365 meeting transcript processing), check if skills/extensions/{name}/SKILL.md exists:
- Installed: Read the extension's
SKILL.md and execute its specialized workflow.
- Not Installed (Interactive Installation):
- Ask the user:
"💡 Notice: The '{extension-name}' extension provides enhanced domain formatting for this task. Would you like me to install it for you?"
- User Approves: Install the extension into
skills/extensions/{extension-name}/ and execute its specialized workflow immediately.
- User Declines / Skip: Proceed with the graceful fallback to core
memorb-ingest or memorb-query.
Red Flags
Stop and revert if rationalizing any of the following:
- "It's simple, no need to read sub-skills" → Router rules are mandatory for all file ops.
- "Place notes in root temporarily" → New notes belong in
memorbs/HQ/OrbTrack/ or PARA folders.
- "I recall the rules without reading" → Always re-read SKILL.md as rules evolve.
1---2name: memorb3description: Gateway skill for Second Brain operations (read/write orbs, OrbTrack capture & triage, ingest, query, lint, archive, memory replay, meetings, business cards). Read first to route to appropriate sub-skills.4---56# Memorb (Gateway Skill)78> **CRITICAL**: Primary routing hub for the vault. Every file operation must strictly follow these instructions and sub-skill routing without exception.910## Instruction Priority111. **Explicit User Instructions** (highest)122. **Memorb & Routed Sub-skills** (overrides default agent behavior)133. **Default Agent Behavior** (lowest)1415## Core Rules16Before performing any file operation:171. Read this gateway file.182. Read `SKILL.md` for **every matching sub-skill** in the routing table below.193. All write operations must adhere to `memorb-conventions` (paths, naming, frontmatter).204. Load multiple sub-skills if needed (e.g., transcript processing = `recording-transcription` + `memorb-ingest`).2122### Ownership boundary23**memOrb may read anything the user points it at; it writes only inside `memorbs/`.** No exceptions — this binds extensions too.2425Reading is safe: no state change, no surprise. Conditional *writing* is where the trouble lives. The moment a skill says "write to the reference folder if it exists", the same operation produces three different outcomes depending on a coincidence of folder naming — it writes for one user, silently skips for the user who numbered their folders, and does nothing for the user who has none. That is worse than either owning the folder or never touching it.2627So memOrb grows exactly one folder in the user's vault: `memorbs/`. Delete it and the vault is clean.2829## Skill Router Table30Core skills reside in `skills/core/{name}/SKILL.md`.31Extensions reside in `skills/extensions/{name}/SKILL.md`.3233### Core Skills (`memorb-core`)34| Sub-skill | Location | Trigger / Scenario |35| :--- | :--- | :--- |36| **memorb-conventions** | `core/memorb-conventions` | Base layer: paths, directory structure (`memorbs/`), naming, frontmatter, templates. Required for ALL write ops. |37| **memorb-born** | `core/memorb-born` | Vault initialization (Phase 0), persona seed setup, CLAUDE.md generation, or `/memorb-born` reset. |38| **orbtrack-triage** | `core/orbtrack-triage` | Ingest Pass 2: Impact Scan on Long-Term entity pages, PARA organization, and zero-leftover triage of `memorbs/HQ/OrbTrack/`. |39| **island-reclamation** | `core/island-reclamation` | Create new Island (long-term interest/responsibility domain): discuss structure before file creation |40| **dream-studio** | `core/dream-studio` | Monthly memory replay: propose Core orbs, add/revise Belief orbs, refresh Island narrative. **Sole writer of `memorbs/HQ/Core/`.** |41| **memorb-ingest** | `core/memorb-ingest` | Ingest Pass 1: Auto-capture conversation stories/experiences or distill raw files (PDFs, transcripts) into atomic notes in `memorbs/HQ/OrbTrack/`. |42| **memorb-query** | `core/memorb-query` | Q&A, comparisons, decision recommendations via `memorbs/Long-Term/`／`memorbs/` wiki |43| **memorb-lint** | `core/memorb-lint` | Vault health check and `memorbs/Long-Term/`／`memorbs/` wiki MUSTY linting |44| **memorb-forgetter** | `core/memorb-forgetter` | Execute MUSTY archiving to `memorbs/Dump/` and update vault Wiki Links |45| **writing-memorb-skills** | `core/writing-memorb-skills` | Create/modify vault skills (Meta) |464748### Extension Skills (`memorb-extensions`)49| Sub-skill | Location | Trigger / Scenario |50| :--- | :--- | :--- |51| **recording-transcription** | `extensions/recording-transcription` | Non-Teams voice recordings (phone, interview, m4a) to transcript |52| **business-card-ingestion** | `extensions/business-card-ingestion` | Business cards to `memorbs/Long-Term/People/` entity notes |53| **memorb-domain-query** | `extensions/memorb-domain-query` | Bi-directional domain/email lookup & M365/Outlook integration |5455## Extension Interactive Installation & Fallback Protocol56If a scenario calls for an extension (e.g. business card OCR, M365 meeting transcript processing), check if `skills/extensions/{name}/SKILL.md` exists:571. **Installed**: Read the extension's `SKILL.md` and execute its specialized workflow.582. **Not Installed (Interactive Installation)**:59 - Ask the user: `"💡 Notice: The '{extension-name}' extension provides enhanced domain formatting for this task. Would you like me to install it for you?"`60 - **User Approves**: Install the extension into `skills/extensions/{extension-name}/` and execute its specialized workflow immediately.61 - **User Declines / Skip**: Proceed with the graceful fallback to core `memorb-ingest` or `memorb-query`.6263## Red Flags64Stop and revert if rationalizing any of the following:65- *"It's simple, no need to read sub-skills"* → Router rules are mandatory for all file ops.66- *"Place notes in root temporarily"* → New notes belong in `memorbs/HQ/OrbTrack/` or PARA folders.67- *"I recall the rules without reading"* → Always re-read SKILL.md as rules evolve.
iamjosuho