Teach Me — Vault Knowledge Export
DeepOrbit and teach-me are
siblings: DeepOrbit manages the knowledge vault; teach-me turns work into a
learner portrait and knowledge tree. This skill exports vault knowledge into
teach-me with provenance — imported notes carry an origin block so they
never mix with knowledge teach-me accumulates natively.
Workflow
Check teach-me is installed. The bridge needs
teach_me.py. Resolution order:--scriptflag →$TEACH_ME_SCRIPT→ common install locations (~/.claude/skills/teach-me/…,~/.agents/…,~/.codex/…,~/.omp/…). If missing, tell the user to install teach-me-skill first.Confirm scope with the user. Default export dirs are knowledge-only:
40_Wiki,60_Notes,30_Research. Opt-in additions:15_Writings,20_Projects.70_Familyis private — export it only on explicit request. Read-only zones (e.g.60_Notes/微信读书) are always skipped: the upstream sync owns them.Run the export:
deeporbit --vault . teach-me export [--dirs 40_Wiki 60_Notes 30_Research 15_Writings]The command stages the notes, runs
teach_me.py import --source obsidian, and returns JSON:origin(provenance block),prompt_for_ai(distillation instructions),deeporbit.exported_notes, and teach-me'snote_paths/text_preview.Distill into teach-me. Follow
prompt_for_ai: for each important knowledge point, call teach-me'scaptureorassess— and pass theoriginobject verbatim at the top level of every payload. This is what keeps imported knowledge distinguishable (note frontmatter getsorigin: import,imported_from,import_id; concept state and knowledge-tree nodes store the block; provenance is first-wins).Report. Summarize: how many notes were exported, which dirs, the
import_id, and how many knowledge points were captured/assessed. Suggest a re-export cadence (e.g. monthly, or after big research pushes) — repeat imports are safe because teach-me skips its owntype: teach-me/*notes and merges concepts by title.
Guardrails
- NEVER drop the
originblock from capture/assess payloads after an export. - NEVER export read-only zones or
70_Familyunless the user explicitly asks. - The export reads the vault; it writes nothing into it.