Memory Capture
Save important context to persistent memory using the MCP memory-service.
How to Use
Manual Invocation
/capture "Pinnacle Title invoice is $1,500/month"
/capture "Billy V4 LONGS ONLY - shorts lost $2,226 in backtests" --type decision
/capture "API key stored in /root/.env" --type reference --tags trading,credentials
Automatic Invocation
When you detect important context in conversation (decisions, learnings, client info, etc.),
call this skill SILENTLY without asking the user. Just capture and continue.
Arguments
$ARGUMENTS or $0: The content to capture
--type TYPE: Memory type (decision, pattern, learning, preference, client, gotcha, reference)
--tags TAG1,TAG2: Comma-separated tags for categorization
Memory Types
| Type |
Use When |
decision |
Architectural/technical choices made |
pattern |
Reusable code/workflow patterns discovered |
learning |
New knowledge or insights |
preference |
User preferences and likes/dislikes |
client |
Client names, contacts, business info |
gotcha |
Pitfalls, bugs, things to avoid |
reference |
File paths, API locations, credentials locations |
Execution Steps
- Parse the input: Extract content, type, and tags from arguments
- Auto-classify: Infer type from content if not provided
- Check for duplicates: Search existing memories - if similar exists, it auto-merges
- Store the memory: Use memory_store with metadata (type, tags, timestamp)
- Silent operation: Do NOT notify user - just capture and continue
Capture Philosophy: REMEMBER EVERYTHING
No filtering. No threshold. Capture aggressively.
When in doubt, capture it. Storage is cheap, lost context is expensive.
The semantic deduplication will handle noise - similar memories get merged automatically.
Quality ratings will surface the good stuff over time.
Capture triggers (if ANY match, capture it):
- Decisions (even tentative ones)
- Learnings (even small ones)
- Names, numbers, dates, amounts
- File paths, URLs, API references
- Preferences (even implied ones)
- Errors and how they were fixed
- Patterns noticed
- Questions asked (context for why we explored something)
The only things to skip:
- Pure greetings ("hi", "thanks")
- Confirmations ("ok", "got it", "sure")
- Meta-discussion about the conversation itself
Auto-Classification Rules
If --type not provided, detect from content:
- Contains "decided", "chose", "going with" →
decision
- Contains "learned", "realized", "discovered" →
learning
- Contains "API", "key", "path", "credentials", ".env" →
reference
- Contains "always", "never", "convention", "pattern" →
pattern
- Contains "careful", "watch out", "gotcha", "bug" →
gotcha
- Contains email, phone, "$", "invoice", company name →
client
- Default →
learning
Auto-Tagging Rules
Extract tags from:
- Project names mentioned (botsniper, foodshot, etc.)
- Technology names (python, node, react, etc.)
- Client names (pinnacle, etc.)
- Domain terms (trading, invoice, api, etc.)
Storage Format
Store using mcp__memory-service__memory_store with:
{
"content": "<the memory content>",
"metadata": {
"type": "<memory type>",
"tags": "<comma-separated tags>",
"source": "capture-skill",
"timestamp": "<ISO timestamp>",
"project": "<current working directory if relevant>"
}
}
Example Execution
User says: "The Airtable API token for Pinnacle is stored in Voltaris-Labs/.env"
Auto-capture (silent):
- Detect: Contains "API", "token", ".env" → type:
reference
- Detect: Contains "Pinnacle", "Airtable" → tags:
pinnacle,airtable,credentials
- Store:
content: "Airtable API token for Pinnacle is stored in Voltaris-Labs/.env"
metadata: {type: "reference", tags: "pinnacle,airtable,credentials,api"}
- Continue conversation without mentioning the capture
Deduplication
Before storing, search for similar memories:
memory_search(query="<content summary>", limit=3)
If highly similar memory exists (same topic):
- Update existing memory quality score instead of creating duplicate
- Use memory_update to add new tags if relevant
Quality Feedback
The memory system learns from feedback. When you notice a memory was:
Useful (helped with a task):
mcp__memory-service__memory_quality(action="rate", content_hash="<hash>", rating="1", feedback="Helped with X")
Not useful (irrelevant or wrong):
mcp__memory-service__memory_quality(action="rate", content_hash="<hash>", rating="-1", feedback="Was outdated/wrong")
Quality scores affect search ranking - highly-rated memories appear first.
Integration with MEMORY.md
For HIGH importance memories (client info, critical decisions), also append to MEMORY.md:
- Location:
~/.claude/projects/*/memory/MEMORY.md
- Format: Brief one-liner under appropriate section
- Only for memories that should be instantly visible at session start
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: itsjwill-claude-memory-capture3description: Memory Capture4---56# Memory Capture78Save important context to persistent memory using the MCP memory-service.910## How to Use1112### Manual Invocation13```14/capture "Pinnacle Title invoice is $1,500/month"15/capture "Billy V4 LONGS ONLY - shorts lost $2,226 in backtests" --type decision16/capture "API key stored in /root/.env" --type reference --tags trading,credentials17```1819### Automatic Invocation20When you detect important context in conversation (decisions, learnings, client info, etc.),21call this skill SILENTLY without asking the user. Just capture and continue.2223## Arguments2425- `$ARGUMENTS` or `$0`: The content to capture26- `--type TYPE`: Memory type (decision, pattern, learning, preference, client, gotcha, reference)27- `--tags TAG1,TAG2`: Comma-separated tags for categorization2829## Memory Types3031| Type | Use When |32|------|----------|33| `decision` | Architectural/technical choices made |34| `pattern` | Reusable code/workflow patterns discovered |35| `learning` | New knowledge or insights |36| `preference` | User preferences and likes/dislikes |37| `client` | Client names, contacts, business info |38| `gotcha` | Pitfalls, bugs, things to avoid |39| `reference` | File paths, API locations, credentials locations |4041## Execution Steps42431. **Parse the input**: Extract content, type, and tags from arguments442. **Auto-classify**: Infer type from content if not provided453. **Check for duplicates**: Search existing memories - if similar exists, it auto-merges464. **Store the memory**: Use memory_store with metadata (type, tags, timestamp)475. **Silent operation**: Do NOT notify user - just capture and continue4849## Capture Philosophy: REMEMBER EVERYTHING5051**No filtering. No threshold. Capture aggressively.**5253When in doubt, capture it. Storage is cheap, lost context is expensive.5455The semantic deduplication will handle noise - similar memories get merged automatically.56Quality ratings will surface the good stuff over time.5758**Capture triggers (if ANY match, capture it):**59- Decisions (even tentative ones)60- Learnings (even small ones)61- Names, numbers, dates, amounts62- File paths, URLs, API references63- Preferences (even implied ones)64- Errors and how they were fixed65- Patterns noticed66- Questions asked (context for why we explored something)6768**The only things to skip:**69- Pure greetings ("hi", "thanks")70- Confirmations ("ok", "got it", "sure")71- Meta-discussion about the conversation itself7273## Auto-Classification Rules7475If `--type` not provided, detect from content:76- Contains "decided", "chose", "going with" → `decision`77- Contains "learned", "realized", "discovered" → `learning`78- Contains "API", "key", "path", "credentials", ".env" → `reference`79- Contains "always", "never", "convention", "pattern" → `pattern`80- Contains "careful", "watch out", "gotcha", "bug" → `gotcha`81- Contains email, phone, "$", "invoice", company name → `client`82- Default → `learning`8384## Auto-Tagging Rules8586Extract tags from:87- Project names mentioned (botsniper, foodshot, etc.)88- Technology names (python, node, react, etc.)89- Client names (pinnacle, etc.)90- Domain terms (trading, invoice, api, etc.)9192## Storage Format9394Store using mcp__memory-service__memory_store with:9596```json97{98 "content": "<the memory content>",99 "metadata": {100 "type": "<memory type>",101 "tags": "<comma-separated tags>",102 "source": "capture-skill",103 "timestamp": "<ISO timestamp>",104 "project": "<current working directory if relevant>"105 }106}107```108109## Example Execution110111User says: "The Airtable API token for Pinnacle is stored in Voltaris-Labs/.env"112113Auto-capture (silent):1141. Detect: Contains "API", "token", ".env" → type: `reference`1152. Detect: Contains "Pinnacle", "Airtable" → tags: `pinnacle,airtable,credentials`1163. Store:117 ```118 content: "Airtable API token for Pinnacle is stored in Voltaris-Labs/.env"119 metadata: {type: "reference", tags: "pinnacle,airtable,credentials,api"}120 ```1214. Continue conversation without mentioning the capture122123## Deduplication124125Before storing, search for similar memories:126```127memory_search(query="<content summary>", limit=3)128```129130If highly similar memory exists (same topic):131- Update existing memory quality score instead of creating duplicate132- Use memory_update to add new tags if relevant133134## Quality Feedback135136The memory system learns from feedback. When you notice a memory was:137138**Useful** (helped with a task):139```140mcp__memory-service__memory_quality(action="rate", content_hash="<hash>", rating="1", feedback="Helped with X")141```142143**Not useful** (irrelevant or wrong):144```145mcp__memory-service__memory_quality(action="rate", content_hash="<hash>", rating="-1", feedback="Was outdated/wrong")146```147148Quality scores affect search ranking - highly-rated memories appear first.149150## Integration with MEMORY.md151152For HIGH importance memories (client info, critical decisions), also append to MEMORY.md:153- Location: `~/.claude/projects/*/memory/MEMORY.md`154- Format: Brief one-liner under appropriate section155- Only for memories that should be instantly visible at session start156157---158> Converted and distributed by [TomeVault](https://tomevault.io/claim/itsjwill) — claim your Tome and manage your conversions.159<!-- tomevault:4.0:skill_md:2026-04-14 -->