| name | topic-graph |
| description | Topic graph exploration for agent-memory. Use when asked to "explore topics", "show related concepts", "what themes have I discussed", "find topic connections", or "discover patterns in conversations". Provides semantic topic extraction with time-decayed importance scoring.
|
Topic Graph Skill
Semantic topic exploration using the agent-memory topic graph.
When to Use
| Use Case | Best Approach |
|---|
| Explore recurring themes | Topic Graph |
| Find concept connections | Topic relationships |
| Discover patterns | Top topics by importance |
| Related discussions | Topics for query |
| Time-based topic trends | Topic with decay |
When Not to Use
- Specific keyword search (use BM25)
- Exact phrase matching (use BM25)
- Current session context (already in memory)
- Cross-project queries (topic graph is per-project)
Quick Start
| Command | Purpose | Example |
|---|
topics status | Topic graph health | topics status |
topics top | Most important topics | topics top --limit 10 |
topics query | Find topics for query | topics query "authentication" |
topics related | Related topics | topics related --topic-id topic:abc |
Prerequisites
memory-daemon status
memory-daemon start
Validation Checklist
Before presenting results:
Topic Graph Status
memory-daemon topics status
Output:
Topic Graph Status
----------------------------------------
Enabled: true
Healthy: true
Total Topics: 142
Active Topics: 89
Dormant Topics: 53
Last Extraction: 2026-01-30T15:42:31Z
Half-Life Days: 30
Explore Top Topics
Get the most important topics based on time-decayed scoring:
memory-daemon topics top --limit 10
memory-daemon topics top --include-dormant
memory-daemon topics top --format json
Query Topics
Find topics related to a query:
memory-daemon topics query "JWT authentication"
memory-daemon topics query "debugging" --min-similarity 0.7
Topic Relationships
Explore connections between topics:
memory-daemon topics related --topic-id "topic:authentication"
memory-daemon topics similar --topic-id "topic:jwt-tokens" --limit 5
Topic-Guided Navigation
Use topics to navigate TOC:
memory-daemon topics nodes --topic-id "topic:authentication"
Error Handling
| Error | Resolution |
|---|
| Connection refused | memory-daemon start |
| Topics disabled | Enable in config: topics.enabled = true |
| No topics found | Run extraction: admin extract-topics |
| Stale topics | Check extraction schedule |
See Command Reference for full CLI options.