0xbigboss-extract-transcripts_skill

Overview

This skill extracts readable Markdown transcripts from Claude Code and Codex CLI session JSONL files. It converts session JSONL into organized transcripts showing metadata, user messages, assistant replies, and optional tool calls or internal thinking. The output is suitable for archiving, searching, or sharing conversational history.

How this skill works

The scripts parse JSONL session files produced by Claude Code and Codex CLI, normalize message roles and timestamps, and render a clean Markdown transcript. Options let you include tool invocation blocks and model thinking blocks, produce summaries only, or batch-process directories. A separate DuckDB indexer can ingest transcripts for fast cross-session search and querying.

When to use it

• You need readable, shareable logs of assistant sessions for audits or documentation.
• You want to extract only meaningful exchanges and skip warmup/empty sessions.
• You need to include or exclude tool calls and internal thinking for compliance or clarity.
• You want to index many sessions for search using DuckDB.
• You need quick summaries instead of full transcripts for review.

Best practices

• Run on the session directory (Claude) or history file (Codex) to batch-process many files.
• Use --skip-empty with --all to avoid storing warmups or noise.
• Include --include-tools and --include-thinking only when needed to preserve sensitive internal content.
• Use the DuckDB indexer for recurring search and analytics across sessions.
• Specify -o to write transcripts to files for archival and version control.

Example use cases

• Convert a single Claude session JSONL into a Markdown file for handoff to teammates.
• Process a project’s session directory to produce a browsable archive of assistant interactions.
• Index months of sessions into DuckDB and run text searches like “error handling” or specific code snippets.
• Extract Codex CLI history as a tool-usage summary to review automated steps taken during a rollout.
• Generate quick summary overviews of sessions for management or compliance review.