memory-capture
Unified memory capture with routing - session compact or quick tips. Triggers on "memory capture", "compact session", "save session", "quick tip", "memory tips", "记录", "压缩会话".
How do I install this agent skill?
npx skills add https://github.com/catlog22/claude-code-workflow --skill memory-captureIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill captures session state and notes to save them into long-term memory. It is generally safe but is susceptible to indirect prompt injection because it stores unsanitized conversation history which could contain malicious instructions from untrusted sources.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
3/3 files flagged
What does this agent skill do?
Memory Capture Skill
Unified memory capture skill that routes to two execution modes:
- Compact: Compress full session memory into structured text for recovery
- Tips: Quick note-taking for ideas, snippets, and insights
Architecture Overview
┌─────────────────────────────────────────────────────┐
│ Memory Capture (Router) │
│ → Parse input → Detect mode → Route to phase │
└───────────────┬─────────────────────────────────────┘
│
┌───────┴───────┐
↓ ↓
┌───────────┐ ┌───────────┐
│ Compact │ │ Tips │
│ (Phase1) │ │ (Phase2) │
│ Full │ │ Quick │
│ Session │ │ Note │
└─────┬─────┘ └─────┬─────┘
│ │
└───────┬───────┘
↓
┌───────────────┐
│ core_memory │
│ (import) │
└───────────────┘
Execution Flow
Step 1: Parse Input & Route
Detect execution mode from user input:
Auto-Route Rules (priority order):
| Signal | Route | Examples |
|---|---|---|
| Keyword: compact, session, 压缩, recovery, 保存会话 | → Compact | "compact current session" |
| Keyword: tip, note, 记录, 快速 | → Tips | "记录一个想法" |
Has --tag or --context flags | → Tips | "note content" --tag bug |
| Short text (<100 chars) + no session keywords | → Tips | "Remember to use Redis" |
| Ambiguous or no arguments | → AskUserQuestion | /memory-capture |
When ambiguous, use AskUserQuestion:
Question: "选择记忆捕获模式"
Options:
1. Compact - 压缩当前完整会话记忆(用于会话恢复)
2. Tips - 快速记录一条笔记/想法/提示
Step 2: Execute Selected Phase
Based on routing result, read and execute the corresponding phase:
- Compact mode → Ref: phases/01-compact.md
- Tips mode → Ref: phases/02-tips.md
Phase Reference Documents (read on-demand when phase executes):
| Mode | Document | Purpose |
|---|---|---|
| Compact | phases/01-compact.md | Full session memory compression and structured export |
| Tips | phases/02-tips.md | Quick note-taking with tags and context |
Step 3: Save via core_memory
Both phases converge on the same storage mechanism:
mcp__ccw-tools__core_memory({
operation: "import",
text: structuredText // Generated by the selected phase
})
Core Rules
- Single Phase Execution: Only ONE phase executes per invocation - never both
- Content Faithful: Phase files contain full execution detail - follow them verbatim
- Absolute Paths: All file paths in output must be absolute
- No Summarization: Compact mode preserves complete plan verbatim - never abbreviate
- Speed Priority: Tips mode should be fast - minimal analysis overhead
Input Processing
Compact Mode Input
- Optional:
"session description"as supplementary context - Example:
/memory-capture compactor/memory-capture "completed auth module"
Tips Mode Input
- Required:
<note content>- the tip/note text - Optional:
--tag <tag1,tag2>for categorization - Optional:
--context <context>for related code/feature reference - Example:
/memory-capture tip "Use Redis for rate limiting" --tag config
Data Flow
User Input
│
├─ [compact detected] → Read phases/01-compact.md
│ → Analyze session → Generate structured text
│ → core_memory import → Report Recovery ID
│
└─ [tips detected] → Read phases/02-tips.md
→ Parse args → Gather context → Generate tip text
→ core_memory import → Confirm with ID + tags
Error Handling
| Error | Action |
|---|---|
| core_memory import fails | Retry once, then report error with structured text for manual save |
| No session context (compact) | Warn user, generate with available info |
| Empty note content (tips) | Ask user to provide content via AskUserQuestion |
| Ambiguous routing | Default to AskUserQuestion - never guess |
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/catlog22/claude-code-workflow/memory-capture">View memory-capture on skillZs</a>