Skip to content

/list-topics

Use when the user asks about topics discussed in the current session, wants to see a topic list, or asks what has been talked about.

shell
$ npx -y skills add hatawong/claude-recap --skill list-topics --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.
  • You can call itInvoke it directly when you want it.
  • Slash command/list-topics
How auto-invocation works

Context preview

The summary Claude sees to decide when to auto-load this skill.

Use when the user asks about topics discussed in the current session, wants to see a topic list, or asks what has been talked about.

SKILL.md

list-topics.SKILL.md
name: list-topics
description: Use when the user asks about topics discussed in the current session, wants to see a topic list, or asks what has been talked about.

list-topics

Overview

Lists all topic slugs found in the current session's JSONL history.

Instructions

1. Get the **session ID** from the SessionStart injection in your context: `[SessionStart] session=SESSION_ID source=...`

2. Get the **plugin scripts path** from the SessionStart injection: `Plugin scripts path: /path/to/scripts`

3. Get the **project ID** from the SessionStart injection: `Your persistent memory is stored at: $HOME/.memory/projects/PROJECT_ID/` Extract the PROJECT_ID segment (e.g. `-Users-alex-my-app`).

4. Run extract-topic.js with `__all__` mode:

node "<plugin_scripts_path>/extract-topic.js" "$HOME/.claude/projects/<project_id>/<session_id>.jsonl" __all__

5. Filter out `__untagged__` from the output, then present using this exact format:

Session Topics:
1. **topic-slug-a**
2. **topic-slug-b**
3. **topic-slug-c**

Current: **topic-slug-c**

Rules

  • If JSONL file doesn't exist or no topics found after filtering, tell the user no topics exist yet.
  • Current topic is from your topic tag (the `› \`slug\`` you've been outputting).
Read it on GitHub ↗
Ships withclaude-recap

Topic-based automatic memory for Claude Code — never lose context across sessions or compactions.

Get the whole plugin, auto-invoked
Stats
38
Stars
0
Views
3
Forks
Maintained
Maintenance
JavaScript
Language
MIT
License
5mo ago
Last commit
5mo ago
Created

Repo: hatawong/claude-recap