Menu
Generate an Excalidraw diagram for the vault. Usage: /learning-loop:diagram "concept or mechanism" or /learning-loop:diagram (infers from context). Produces .excalidraw.md in vault Excalidraw/ folder.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Deep research with the local librarian doing the token-heavy middle. Scope on Claude, Search+Fetch+Extract on the local Ollama model, adversarial Verify + Synthesize back on Claude. Usage: /learning-loop:research "<question>". Falls back to Claude-native WebSearch when the librarian is unavailable or sub-tier.
End-of-session consolidation. Usage: /learning-loop:reflect (no args). Reviews conversation, extracts learnings, routes to auto-memory or vault, cross-links projects, promotes inbox notes. Run after substantial work sessions.
measure whether a /dream pass helps, hurts, or ties against no consolidation. usage: /learning-loop:dream-eval --mode={single|control|repeated} [--passes=N] [--mine]. single scores pre/post on the live corpus; control forks two clones and dreams one; repeated dreams a clone N times and plots the drift + content-survival curve.
Consolidate auto-memory between sessions. Usage: /learning-loop:dream (no args). Four-phase cycle: Orient, Gather Signal, Consolidate, Prune Index. Seven operators: MERGE, RESOLVE, ABSTRACT, COMPRESS, PRUNE, LINK, DATE NORMALIZE. Rebuilds MEMORY.md.
Cross-store correction for a retracted or updated belief. Usage: /learning-loop:rewrite "old pattern" "new pattern" [reason]. Searches vault, auto-memory, and episodic history; presents an impact map for triage; executes user-approved changes; records a supersession so future episodic searches get annotated.
Diagnose your learning-loop installation. Runs health checks, presents issues, offers per-fix remediation, re-runs each check after the fix to confirm. Safe to run anytime; only makes changes you approve. Pass --redact to scan plugin data files for leaked credentials instead.
| name | diagram |
| description | Generate an Excalidraw diagram for the vault. Usage: /learning-loop:diagram "concept or mechanism" or /learning-loop:diagram (infers from context). Produces .excalidraw.md in vault Excalidraw/ folder. |
Generate an Excalidraw diagram and save it to the vault. Handles the full pipeline: determine what to diagram, build the JSON, write the file, and optionally embed it in a note.
/learning-loop:diagram "concept or mechanism" -- user specifies what to diagram/learning-loop:diagram -- infer from conversation contextIf args provided: Use as the concept description.
If no args: Read recent conversation. Identify the most diagram-worthy concept -- a mechanism, pathway, feedback loop, multi-step process, or system architecture where relationships between parts matter more than the parts themselves.
Diagram gate -- check BEFORE proceeding:
If the answer to all three is no, tell the user: "This works better as text/table -- no diagram needed." and stop.
Read the diagram-rules agent file to get the full Excalidraw construction spec:
${CLAUDE_PLUGIN_ROOT}/agents-shared/diagram-rules.md
Follow every rule in that file. Key points:
.excalidraw.md format with empty ## Text Elements section#a5d8ff (blue), #b2f2bb (green), #ffec99 (yellow), #ffc9c9 (red), #d0bfff (purple)fontFamily: 5, roughness: 1frameId, index, versionNonce, or rawText fieldsBefore writing JSON, plan on paper:
Build the full Excalidraw JSON following diagram-rules exactly. Write to:
{{VAULT}}/Excalidraw/{slug}.excalidraw.md
Where {slug} is a descriptive kebab-case name (e.g., tracker-app-engagement-loop-tiers).
File format:
---
excalidraw-plugin: parsed
tags: [excalidraw]
---
==⚠ Switch to EXCALIDRAW VIEW in the MORE OPTIONS menu of this document. ⚠== You can decompress Drawing data with the command palette: 'Decompress current Excalidraw file'. For more info check in plugin settings under 'Saving'
# Excalidraw Data
## Text Elements
%%
## Drawing
```json
{JSON here}
%%
### Step 5: Validate
Check the generated JSON:
1. No overlapping positions (30px minimum between edges)
2. Container text fits (text width < container width - 60px)
3. Arrow first point is `[0, 0]`, width/height match point bounding box
4. All IDs unique
5. No `frameId`, `index`, `versionNonce`, or `rawText` fields present
### Step 6: Report
Diagram: "{title}" -> Excalidraw/{slug}.excalidraw.md Embed with: ![[{slug}]]
If the conversation has an obvious note to embed it in, suggest which note. Otherwise just report the path.
## Key Principles
- **Connections carry meaning.** If you remove the arrows and it still works, it was a layout, not a diagram.
- **Focused scope.** One mechanism per diagram. Split complex systems.
- **Follow diagram-rules exactly.** Read the agent file every time. Don't rely on memory.
- **No extra elements.** Default to free-floating text. Only add containers when the shape itself carries meaning.
- **Calculate widths.** Never hardcode text widths. Compute from character count every time.