Initial commit

skills/distill-memory/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: Distill Memory
+description: Recognize breakthrough moments, blocking resolutions, and design decisions worth preserving. Detect high-value insights that save future time. Suggest distillation at valuable moments, not routine work.
+---
+
+# Distill Memory
+
+## When to Suggest (Moment Detection)
+
+**Breakthrough:** Extended debugging resolves, user relief ("Finally!", "Aha!"), root cause found
+
+**Decision:** Compared options, chose with rationale, trade-off resolved
+
+**Research:** Investigated multiple approaches, conclusion reached, optimal path determined
+
+**Twist:** Unexpected cause-effect, counterintuitive solution, assumption challenged
+
+**Lesson:** "Next time do X", preventive measure, pattern recognized
+
+**Skip:** Routine fixes, work in progress, simple Q&A, generic info
+
+## Memory Quality
+
+**Good (atomic + actionable):**
+
+- "React hooks cleanup must return function. Caused leaks."
+- "PostgreSQL over MongoDB: ACID needed for transactions."
+
+**Poor:** Vague "Fixed bugs", conversation transcript
+
+## Tool Usage
+
+```json
+{
+  "content": "Insight + context for future use",
+  "title": "Searchable (50-60 chars)",
+  "importance": 0.8,
+  "labels": "tech,domain,topic"
+}
+```
+
+**Content:** Outcome/insight focus, include "why", enough context
+
+**Importance:** 0.8-1.0 major | 0.5-0.7 useful | 0.3-0.4 minor
+
+**Labels:** 2-4 max, check existing first, lowercase-hyphenated
+
+## Suggestion
+
+**Timing:** After resolution/decision, when user pauses
+
+**Pattern:** "This [type] seems valuable - [essence]. Distill into memory?"
+
+**Frequency:** 1-3 per session typical, quality over quantity
+
+## Troubleshooting
+
+If the MCP is not installed, you can install it with the following command:
+
+```bash
+claude mcp add --transport http nowledge-mem http://localhost:14242/mcp --scope user
+```

skills/save-thread/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: Save Thread
+description: Save complete conversation as checkpoint. Only when user explicitly requests ("save session", "checkpoint this"). Use thread_persist to store full message history with summary.
+---
+
+# Save Thread
+
+## When to Save
+
+**Only when user explicitly says:**
+"Save this session" | "Checkpoint this" | "Record conversation"
+
+Never auto-save or suggest.
+
+## Tool Usage
+
+```json
+{
+  "client": "claude-code",
+  "project_path": "/Users/username/dev/project-foo",
+  "persist_mode": "current",
+  "summary": "What was accomplished (under 100 chars)"
+}
+```
+
+**project_path:** Ask if unclear
+
+**persist_mode:** `"current"` (default) | `"all"` (only if explicitly requested)
+
+## Thread vs Memory
+
+Thread = full history | Memory = distilled insights (different purposes, can do both)
+
+## Response
+
+```
+✓ Thread saved
+Summary: {summary}
+Messages: {count}
+```
+
+## Troubleshooting
+
+If the MCP is not installed, you can install it with the following command:
+
+```bash
+claude mcp add --transport http nowledge-mem http://localhost:14242/mcp --scope user
+```

skills/search-memory/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: Search Memory
+description: Search memory store when past insights would improve response. Recognize when user's stored breakthroughs, decisions, or solutions are relevant. Search proactively based on context, not just explicit requests.
+---
+
+# Search Memory
+
+## When to Search (Autonomous Recognition)
+
+**Strong signals:**
+
+- Continuity: Current topic connects to prior work
+- Pattern match: Problem resembles past solved issue
+- Decision context: "Why/how we chose X" implies documented rationale
+- Recurring theme: Topic discussed in past sessions
+- Implicit recall: "that approach", "like before"
+
+**Contextual signals:**
+
+- Complex debugging (may match past root causes)
+- Architecture discussion (choices may be documented)
+- Domain-specific question (conventions likely stored)
+
+**Skip when:**
+
+- Fundamentally new topic
+- Generic syntax questions
+- Fresh perspective explicitly requested
+
+## Tool Usage
+
+```json
+{
+  "query": "3-7 core concepts",
+  "limit": 10,
+  "mode": "normal"
+}
+```
+
+**Query:** Extract semantic core, preserve terminology, multi-language aware
+
+**Modes:** `normal` (default fast) | `deep` (comprehensive when needed)
+
+**Scores:** 0.6-1.0 direct | 0.3-0.6 related | <0.3 skip
+
+**Optional:** `"filter_labels": "backend,architecture"`
+
+## Response
+
+Found: Synthesize, cite when helpful
+None: State clearly, suggest distilling if current discussion valuable
+
+## Troubleshooting
+
+If the MCP is not installed, you can install it with the following command:
+
+```bash
+claude mcp add --transport http nowledge-mem http://localhost:14242/mcp --scope user
+```