Session Search Skill for Claude

This skill should be used when searching Claude Code session transcripts with semantic understanding. Triggers on queries like "find sessions about X", "when did I work on Y", "search previous conversations". Supports natural language queries with synonym matching.

3k tokens

context cost

the whole folder, loaded on every use

files

ships runnable scripts

copies elsewhere

how many repositories repackaged it

337

stars on the repo

on the repository, not the skill itself

Install

one command, takes just this skill from the repository

npx skills add https://github.com/glebis/claude-skills --skill session-search

What comes with it

8 788 bytes besides the instruction

.claude-plugin/plugin.json

scripts/search.py

The instruction itself

7 sections, as written by the author

Session Search

Search Claude Code session transcripts by combining keyword pre-filtering with semantic evaluation. Finds previous sessions about specific topics, debugging conversations, research tasks, or any past work.

Workflow

Step 1: Run the search script

Execute scripts/search.py with the user's query:

python3 scripts/search.py "<query>" [max_results] [max_age_days]

query (required): Natural language search query
max_results (optional, default 10): Maximum results to return
max_age_days (optional, default 90): How far back to search

The script performs keyword pre-filtering across all sessions, then extracts meaningful excerpts from top candidates. Output contains a SESSIONS_DATA JSON block.

Step 2: Evaluate results semantically

After receiving the script output, evaluate each session's relevance to the query. Consider:

Synonym matching: "bug" matches "error", "issue", "problem", "fix"
Related concepts: "debugging" matches sessions with test failures or error messages
Tool patterns: "refactoring" matches Edit-heavy sessions
Domain context: "obsidian" matches vault-related work

Assign a relevance score (0-10) to each session based on excerpt content and query intent.

Step 3: Present results

Display the top results (up to max_results) sorted by relevance, formatted as:

### [Relevance: N/10] Project — Date
Summary of what the session was about (1-2 sentences based on excerpts)
`claude --resume <session-id>`

If no relevant results are found, report that and suggest alternative queries.

Session Storage

Sessions are stored as JSONL files in ~/.claude/projects/. Each file contains events with user/assistant messages and tool calls. The search script handles file discovery and text extraction automatically.

Customization

To search older sessions or get more results:

/session-search "query" 20 180

(20 results, 180 days lookback)

Other skills for the same job

different authors, same section of the catalogue

Skill Creator

by anthropics

vendor ×10

Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.

Replace with description of the skill and when Claude should use it.

35 tokens

Dispatching Parallel Agents

by ZhanlinCui

×5

Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies

This skill should be used when the user wants to "create a skill", "add a skill to plugin", "write a new skill", "improve skill description", "organize skill content", or needs guidance on skill structure, progressive disclosure, or skill development best practices for Claude Code plugins.

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

Use when creating new skills, editing existing skills, or verifying skills work before deployment

26k tokens scripts

How to use it

Copy the folder

Take glebis/session-search from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.