Memory delta
Auto-executes when the [CRABSHELL_DELTA] trigger is detected. Calls delta-summarizer agent to summarize and append to logbook.md. Not user-invocable — triggered automatically.From its SKILL.md
npx -y skills add ZipperBagCoffee/crabshell --skill memory-deltaAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
2.7 KB, as published. Nobody here has run it
Project Root Resolution
IMPORTANT: Get the project root from your context's "Project Root Anchor" section.
Look for: Your ACTUAL project root is: <path>
Use this value as {PROJECT_DIR} in all commands below.
If not available in context, use your current working directory.
Trigger Condition
Auto-invoked when EITHER:
- Hook stderr outputs:
[CRABSHELL_DELTA] file=delta_temp.txt - Context contains:
[CRABSHELL_DELTA]trigger pattern
If you see [CRABSHELL_DELTA] anywhere in your context, execute this skill immediately.
Execution Steps
Step 1: Verify file exists (DO NOT SKIP):
Use the Read tool to read {PROJECT_DIR}/.crabshell/memory/delta_temp.txt (limit 5 lines). If file not found or empty, STOP HERE - do not proceed.
Step 2: Call delta-summarizer agent (foreground):
Prompt: "Read {PROJECT_DIR}/.crabshell/memory/delta_temp.txt and summarize (1 sentence per ~200 words)."
Step 3: Validate response:
- If response starts with "ERROR:" → STOP
- If response is empty → STOP
Step 4: Append summary to logbook.md and mark appended:
- Write the summary text to a temp file: Use Write tool to save ONLY the summary text (the new entry with timestamp header) to
{PROJECT_DIR}/.crabshell/memory/delta_summary_temp.txt - Run via Bash:
"C:/Program Files/nodejs/node.exe" "{PLUGIN_ROOT}/scripts/append-memory.js" --project-dir="{PROJECT_DIR}"(Reads delta_summary_temp.txt, appends to logbook.md with dual timestamps, cleans up temp file) - Run via Bash:
"C:/Program Files/nodejs/node.exe" "{PLUGIN_ROOT}/scripts/extract-delta.js" mark-appended --project-dir="{PROJECT_DIR}"(SetsmemoryAppendedInThisRun=truein memory-index.json)
Step 5: Update timestamp marker:
Run via Bash: "C:/Program Files/nodejs/node.exe" "{PLUGIN_ROOT}/scripts/extract-delta.js" mark-updated --project-dir="{PROJECT_DIR}"
(Moves pendingLastProcessedTs → lastMemoryUpdateTs, or uses current ISO timestamp as fallback)
Step 6: Clean up temp file:
Run via Bash: "C:/Program Files/nodejs/node.exe" "{PLUGIN_ROOT}/scripts/extract-delta.js" cleanup --project-dir="{PROJECT_DIR}"
(Verifies logbook.md was updated, deletes delta_temp.txt, clears deltaReady and memoryAppendedInThisRun)
Failure Handling
- If file doesn't exist in Step 1: STOP immediately
- If summarizer fails in Step 2: Don't update timestamp, don't delete temp file
- Next trigger will retry with accumulated content (temp file overwritten)