Agent skill

Session Search

by glebis in glebis/claude-skills

This skill should be used when searching Claude Code session transcripts with semantic understanding.

MITAuto-check passed

Install Session Search

skills CLI
$ npx skills add glebis/claude-skills --skill session-search -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install glebis/claude-skills session-search --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/glebis/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/session-search .claude/skills/session-search && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
session-search
GitHub stars
389
Token cost
~571 tokens
SKILL.md length
221 words
Files
3 (incl. scripts)
Skills in repo
91
Repo updated
First seen
Licence
MIT

At a glance

This skill should be used when searching Claude Code session transcripts with semantic understanding.

  • Works in 3 steps: Run the search script → Evaluate results semantically → Present results
  • Queries like find sessions about X
  • SKILL.md covers Workflow, Session Storage and Customization
  • Runs Python scripts from its folder; calls python3

What it does

Session Search is an agent skill from glebis/claude-skills. 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.

Its SKILL.md is about 570 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `.claude-plugin/plugin.json` and `scripts/search.py`).

The repository describes itself as: Collection of Claude Code skills for enhanced AI workflows. The licence is MIT.

When your agent uses it

  • Queries like find sessions about X
  • Did I work on Y
  • Search previous conversations

Example prompts

  • “find sessions about X”
  • “when did I work on Y”
  • “search previous conversations”
  • “/session-search”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Run the search script
  2. Evaluate results semantically
  3. Present results

What it can do on your machine

Read from SKILL.md and the folder at commit 7524dff. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Session Search loads about 571 tokens when it runs. Until then it costs about 70 tokens; SKILL.md has 221 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~70
When it runs · the whole SKILL.md, loaded when a task matches
~571

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from glebis/claude-skills at commit 7524dff, republished under its MIT licence (© glebis). 221 words, ~571 tokens.

Download SKILL.mdSave it as .claude/skills/session-search/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
session-search
description
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.

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:

bash
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)

© glebis, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts) in session-search of glebis/claude-skills.

  • SKILL.md
  • .claude-plugin/plugin.json
  • scripts/search.py

Open the folder on GitHubat commit 7524dff

Compare with similar skills

Session Search next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Session Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Session Search this skillglebis/claude-skills389—~571Automated safety check: PassMIT
Searchdavila7/claude-code-templates32k1 repos~339Automated safety check: PassMIT
Algolia Searchdavila7/claude-code-templates32k4 repos~492Automated safety check: PassMIT
Perplexity Web Searchdavila7/claude-code-templates32k12 repos~3.5kAutomated safety check: NotesMIT
X Search via xAIcode-yeongyu/oh-my-openagent70k—~1.4kAutomated safety check: PassCustom licence
Website Searchthedaviddias/Front-End-Checklist74k—~556Automated safety check: PassMIT

Similar skills

  • Search

    davila7/claude-code-templates

    Search Google via Bright Data SERP API. An agent skill from davila7/claude-code-templates.

    32k GitHub starsUsed in 1 repo~339 tokens
    Productivity & AutomationAuto-check passed
  • Algolia Search

    davila7/claude-code-templates

    Expert patterns for Algolia search implementation, indexing strategies, React InstantSearch, and relevance tuning Use when: adding search to, algolia, instantsearch, search api, search functionality.

    32k GitHub starsUsed in 4 repos~492 tokens
    Backend & APIsAuto-check passed
  • Perplexity Web Search

    davila7/claude-code-templates

    Runs web-grounded searches through Perplexity's Sonar models over OpenRouter for current events, recent literature and cited facts beyond the model's training cutoff.

    32k GitHub starsUsed in 12 repos~3.5k tokens
    Research & ScienceAuto-check: notes
  • X Search via xAI

    code-yeongyu/oh-my-openagent

    Rules for using the x_search tool to search X (Twitter) through a connected xAI account: date-bound queries, trusted handles, search operators and split searches.

    70k GitHub stars~1.4k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Website Search

    thedaviddias/Front-End-Checklist

    A skill your agent uses when applies to sites with internal site search functionality.

    74k GitHub stars~556 tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Firecrawl Search Integration

    firecrawl/firecrawl

    Guidance for adding Firecrawl's /search endpoint to product code and agent workflows when a feature starts from a query rather than a URL.

    190k GitHub starsUsed in 1 repo~1.1k tokens
    Backend & APIsAuto-check passed

More from glebis/claude-skills

All 91 skills in this repo
  • Runs a human-first workflow for labeling PII spans in a transcript, then scores inter-annotator agreement and drafts an adjudicated gold set.

    389 GitHub stars~1.3k tokensUpdated 12 days ago
    Auto-check passed
  • Automates a dedicated, logged-in Chrome instance per profile without ever closing the user's own open tabs or browser windows.

    389 GitHub stars~973 tokensUpdated 12 days ago
    Auto-check passed
  • Deep Research

    glebis/claude-skills

    This skill should be used when conducting comprehensive research on any topic using the OpenAI Deep Research API.

    389 GitHub stars~2.6k tokensUpdated 12 days ago
    Auto-check: notes
  • Elimination Research

    glebis/claude-skills

    This skill should be used for elimination-style research where the user wants to choose from a shortlist of products, tools, services, vendors, or other options using explicit criteria, numeric…

    389 GitHub stars~1.6k tokensUpdated 12 days ago
    Auto-check passed
  • Narrated HTML Presentations

    glebis/claude-skills

    Generates a self-contained HTML presentation with article and slides modes, ElevenLabs voiceover narration and optional GPT Image 2 illustrations.

    389 GitHub stars~2.3k tokensUpdated 12 days ago
    Auto-check: notes
  • Writes fictional but realistic coaching or therapy session transcripts for evals, demos and few-shot examples, in several modalities and export formats.

    389 GitHub stars~2.9k tokensUpdated 12 days ago
    Auto-check passed

Questions about Session Search

What does Session Search do?

This skill should be used when searching Claude Code session transcripts with semantic understanding. Session Search is an agent skill from glebis/claude-skills. This skill should be used when searching Claude Code session transcripts with semantic understanding.

When should I use Session Search?

Session Search fits situations like: queries like find sessions about X; did I work on Y; search previous conversations.

How do I install Session Search in Claude Code?

Run `npx skills add glebis/claude-skills --skill session-search -a claude-code`. Or copy the skill folder (session-search in glebis/claude-skills) into .claude/skills/session-search in your project. Claude Code loads it when a task matches its description.

How do I install Session Search in Codex?

Run `npx skills add glebis/claude-skills --skill session-search -a codex`. Or copy the skill folder (session-search in glebis/claude-skills) into .agents/skills/session-search in your project. Codex loads it when a task matches its description.

Can I use Session Search in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add glebis/claude-skills --skill session-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/session-search, .gemini/skills/session-search, .github/skills/session-search and .opencode/skills/session-search in your project.

What does Session Search need to run?

Going by SKILL.md and its folder, Session Search needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Session Search access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Session Search safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Session Search use?

Session Search is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Session Search use?

About 571 tokens (SKILL.md is roughly 2.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Session Search?

Skills that share tags, products or a category with Session Search: Search (davila7/claude-code-templates, 32k stars), Algolia Search (davila7/claude-code-templates, 32k stars), Perplexity Web Search (davila7/claude-code-templates, 32k stars) and X Search via xAI (code-yeongyu/oh-my-openagent, 70k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Session Search?

glebis (a GitHub user) maintains it in glebis/claude-skills, which has 389 GitHub stars. The repository holds 91 skills in this directory. The repository was last updated on September 26, 2026.

Source: glebis/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.