skills.rest
wbelk
wbelkCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

qmd-sessions

Converts Claude Code JSONL session transcripts into searchable Markdown files and indexes them in qmd.

47|5|Updated Mar 3, 2026
Search Tags:#markdown#indexing#session-management#claude-code#transcripts#semantic-search#qmd
One-click install
npx skills add https://github.com/wbelk/claude-qmd-sessions --skill qmd-sessions
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: qmd-sessions
Source: https://github.com/wbelk/claude-qmd-sessions/tree/main
Command: npx skills add https://github.com/wbelk/claude-qmd-sessions --skill qmd-sessions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts Claude Code session transcripts stored in ~/.claude/projects/ into clean, searchable Markdown files and indexes them in qmd for fast semantic search and retrieval.

Core Features & Use Cases

  • Convert all JSONL session transcripts into structured Markdown per session, preserving project directories and date-based filenames.
  • Extract user and assistant turns while skipping tool blocks and system tags; supports subagent transcripts and maintains a consistent, indexable format.
  • Index content in qmd via MCP for fast semantic and keyword search; hooks keep the index current as sessions evolve.
  • Use /qmd-sessions refresh to load the most recent exchanges into the current context for fresh sessions.

Quick Start

Run /qmd-sessions to begin the interactive setup wizard and convert your transcripts.

Frequently Asked Questions about qmd-sessions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert Claude Code session transcripts to markdown?▼

Claude Code transcripts stored as JSONL files in ~/.claude/projects/ are converted into structured, searchable Markdown files preserving project directories and date-based filenames.

Can I search through my Claude Code session history with semantic search?▼

Yes, transcripts are indexed in qmd via MCP for fast semantic and keyword search, with hooks that keep the index current as sessions evolve.

How do I load recent Claude Code exchanges into a fresh session?▼

Run /qmd-sessions refresh to load the most recent exchanges from your transcripts into the current context for new sessions.

What is the best way to set up transcript indexing for Claude Code?▼

Run /qmd-sessions to launch a guided, step-by-step setup wizard that safely configures transcript conversion and qmd indexing across sessions.

Does the transcript conversion preserve subagent conversations?▼

The conversion extracts user and assistant turns while skipping tool blocks and system tags, and it supports subagent transcripts to maintain a consistent, indexable format.

Related Skills

Explore More Software Engineering Skills→
brandon-frysliebrandon-fryslie
4

find-session

Search JSONL transcript files for keyword matches and retrieve message context.

Community
Intermediate
mpsuessermpsuesser

qmd-cli

Search indexed text corpora using qmd commands instead of grep.

Community
Intermediate
mamba-mentalmamba-mental

MCP Integration

Integrate external MCP servers with Claude Code plugins across stdio, SSE, HTTP, and WebSocket.

Community
Advanced
fortunto2fortunto2
18

solo-index-youtube

Index YouTube transcripts into a searchable local knowledge store with metadata and topic extraction.

Community
Intermediate