New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Session Finder

by glebis in glebis/claude-skills

Index and search Claude Code sessions using semantic embeddings (Gemini).

MITAuto-check passedAI & LLM Engineering

Install Session Finder

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

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

GitHub CLI
$ gh skill install glebis/claude-skills session-finder --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-finder .claude/skills/session-finder && 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-finder
GitHub stars
390
Token cost
~402 tokens
SKILL.md length
124 words
Files
3 (incl. scripts)
Skills in repo
92
Repo updated
First seen
Licence
MIT

At a glance

Index and search Claude Code sessions using semantic embeddings (Gemini).

  • Works in 4 steps: Document extraction — deterministic, no… → Embedding — documents are embedded with… → Storage — SQLite at… → …
  • Which session did I
  • SKILL.md covers Commands, How it works and Workflow
  • Runs Python scripts from its folder; calls python3 and claude

What it does

Session Finder is an agent skill from glebis/claude-skills. Index and search Claude Code sessions using semantic embeddings (Gemini). Find past sessions by topic, relaunch the best match. Triggers on "find session", "which session did I", "relaunch the session where", "session about X".

Its SKILL.md is about 400 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/session_finder.py`).

It sits in AI & LLM Engineering, covering Embeddings. The repository describes itself as: Collection of Claude Code skills for enhanced AI workflows. The licence is MIT.

When your agent uses it

  • Which session did I
  • Relaunch the session where
  • Session about X

Example prompts

  • “find session”
  • “which session did I”
  • “relaunch the session where”
  • “/session-finder”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Document extraction — deterministic, no LLM. Each session JSONL is parsed into a structured document
  2. Embedding — documents are embedded with gemini-embedding-exp-03-07 via llm CLI
  3. Storage — SQLite at ~/.claude/session-finder.db
  4. Search — query is embedded, cosine similarity ranks all sessions, top match is the default to open

What it can do on your machine

Read from SKILL.md and the folder at commit 3b88261. 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
    • claude

    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 Finder loads about 402 tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 124 words of instructions outside code blocks.

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

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 3b88261, republished under its MIT licence (© glebis). 124 words, ~402 tokens.

Download SKILL.mdSave it as .claude/skills/session-finder/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
session-finder
description
Index and search Claude Code sessions using semantic embeddings (Gemini). Find past sessions by topic, relaunch the best match. Triggers on "find session", "which session did I", "relaunch the session where", "session about X".

Session Finder

Semantic search across Claude Code sessions using Gemini embeddings.

Commands

Index sessions
bash
python3 ~/.claude/skills/session-finder/scripts/session_finder.py index [--max-age-days 90]
bash
python3 ~/.claude/skills/session-finder/scripts/session_finder.py search "query" [--top 5]
Open best match directly
bash
python3 ~/.claude/skills/session-finder/scripts/session_finder.py open "query"
Stats
bash
python3 ~/.claude/skills/session-finder/scripts/session_finder.py stats

How it works

  1. Document extraction — deterministic, no LLM. Each session JSONL is parsed into a structured document:
    • away_summary events (pre-existing Claude recaps) if available
    • First user message (task description)
    • Follow-up user messages (condensed)
    • First assistant response
    • Tools used
    • Project name
  2. Embedding — documents are embedded with gemini-embedding-exp-03-07 via llm CLI
  3. Storage — SQLite at ~/.claude/session-finder.db
  4. Search — query is embedded, cosine similarity ranks all sessions, top match is the default to open

Workflow

When user asks to find a session:

  1. Run search with their query
  2. Present results with confidence scores
  3. Offer to resume the top match via claude --resume <id>

© 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-finder of glebis/claude-skills.

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

Open the folder on GitHubat commit 3b88261

Compare with similar skills

Session Finder 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 Finder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Session Finder this skillglebis/claude-skills390—~402Automated safety check: PassMIT
Chroma Vector DatabaseOrchestra-Research/AI-Research-SKILLs13k7 repos~2.3kAutomated safety check: PassMIT
SageMaker Serving Image Selectionhuggingface/skills11k1 repos~4.6kAutomated safety check: PassApache-2.0
Codebase Managementgiancarloerra/SocratiCode3.3k1 repos~1.8kAutomated safety check: PassAGPL-3.0
CLIP Image-Text MatchingOrchestra-Research/AI-Research-SKILLs13k7 repos~1.7kAutomated safety check: PassMIT
Sentence-Transformers Training Routerhuggingface/skills11k1 repos~2.6kAutomated safety check: PassApache-2.0

Similar skills

  • Chroma Vector Database

    Orchestra-Research/AI-Research-SKILLs

    Shows how to store documents and embeddings in Chroma, query them by similarity with metadata filters, and persist them to disk for RAG and semantic search projects.

    13k GitHub starsUsed in 7 repos~2.3k tokens
    AI & LLM EngineeringAuto-check passed

  • SageMaker Serving Image Selection

    huggingface/skills

    Official

    Chooses the right serving container and current image URI for deploying a Hugging Face model to a SageMaker endpoint, preferring Hugging Face images over generic ones.

    11k GitHub starsUsed in 1 repo~4.6k tokens
    AI & LLM EngineeringAuto-check passed

  • Codebase Management

    giancarloerra/SocratiCode

    Set up, index, and manage SocratiCode codebase indexing. An agent skill from giancarloerra/SocratiCode.

    3.3k GitHub starsUsed in 1 repo~1.8k tokens
    AI & LLM EngineeringAuto-check passed

  • CLIP Image-Text Matching

    Orchestra-Research/AI-Research-SKILLs

    Explains OpenAI's CLIP model for zero-shot image classification, image-text similarity, semantic image search and content moderation, with install steps and code patterns.

    13k GitHub starsUsed in 7 repos~1.7k tokens
    AI & LLM EngineeringAuto-check passed

  • Sentence-Transformers Training Router

    huggingface/skills

    Official

    Routes a sentence-transformers training task to the right model type and required reference docs and example scripts, covering bi-encoders, rerankers, sparse and multi-vector models.

    11k GitHub starsUsed in 1 repo~2.6k tokens
    AI & LLM EngineeringAuto-check passed

  • Mashup Mods

    rehan-remade/universal-modder

    Build cross-game mashups and total conversions, the "Minecraft inside Elden Ring" or "skateboarding in MW2" kind.

    5.8k GitHub stars~3.3k tokensUpdated today
    AI & LLM EngineeringAuto-check passed

More from glebis/claude-skills

All 92 skills in this repo

  • PII Annotation and Agreement Scorer

    glebis/claude-skills

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

    390 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed

  • Non-Destructive Chrome Automation

    glebis/claude-skills

    Automates a dedicated, logged-in Chrome instance per profile without ever closing the user's own open tabs or browser windows.

    390 GitHub stars~973 tokensUpdated yesterday
    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.

    390 GitHub stars~2.6k tokensUpdated yesterday
    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…

    390 GitHub stars~1.6k tokensUpdated yesterday
    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.

    390 GitHub stars~2.3k tokensUpdated yesterday
    Auto-check: notes

  • Synthetic Coaching Session Generator

    glebis/claude-skills

    Writes fictional but realistic coaching or therapy session transcripts for evals, demos and few-shot examples, in several modalities and export formats.

    390 GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Session Finder

What does Session Finder do?

Index and search Claude Code sessions using semantic embeddings (Gemini). Session Finder is an agent skill from glebis/claude-skills. Index and search Claude Code sessions using semantic embeddings (Gemini).

When should I use Session Finder?

Session Finder fits situations like: which session did I; relaunch the session where; session about X.

How do I install Session Finder in Claude Code?

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

How do I install Session Finder in Codex?

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

Can I use Session Finder 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-finder -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-finder, .gemini/skills/session-finder, .github/skills/session-finder and .opencode/skills/session-finder in your project.

What does Session Finder need to run?

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

Does Session Finder 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 Finder 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 Finder use?

Session Finder 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 Finder use?

About 402 tokens (SKILL.md is roughly 1.6k 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 Finder?

Skills that share tags, products or a category with Session Finder: Chroma Vector Database (Orchestra-Research/AI-Research-SKILLs, 13k stars), SageMaker Serving Image Selection (huggingface/skills, 11k stars), Codebase Management (giancarloerra/SocratiCode, 3.3k stars) and CLIP Image-Text Matching (Orchestra-Research/AI-Research-SKILLs, 13k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Session Finder?

glebis (a GitHub user) maintains it in glebis/claude-skills, which has 390 GitHub stars. The repository holds 92 skills in this directory. The repository was last updated on October 8, 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.