conversation-format

Parse Claude Code JSONL conversation files to extract text, thinking, and tool_use blocks.

28|3|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/oborchers/fractional-cto --skill conversation-format
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: conversation-format
Source: https://github.com/oborchers/fractional-cto/tree/main/retell/skills/conversation-format
Command: npx skills add https://github.com/oborchers/fractional-cto --skill conversation-format

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenge of extracting meaningful signal from Claude Code's complex JSONL conversation logs, which are often filled with noise and metadata.

Core Features & Use Cases

  • Signal Extraction: Identifies and extracts valuable user and assistant messages, along with crucial metadata like turn duration.
  • Noise Filtering: Intelligently discards irrelevant entries such as progress updates and internal system events.
  • Content Block Parsing: Differentiates and extracts key information from text, thinking, and tool_use blocks, while selectively handling image data.
  • Subagent Linking: Provides a method to link main conversation tool uses to their corresponding subagent transcripts.
  • PII Scanning: Includes a mechanism to flag potential Personally Identifiable Information (PII) and secrets within the conversation data.
  • Use Case: When analyzing past conversations to understand AI decision-making or to repurpose content, this skill ensures you only process the essential narrative elements, saving significant time and computational resources.

Quick Start

Use the conversation-format skill to parse the conversation transcript located at ~/.claude/projects/example-project/conversation-uuid.jsonl.

Frequently Asked Questions about conversation-format

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

FAQPage Schema
How do I parse Claude Code JSONL conversation logs to extract user and assistant messages?

To parse Claude Code JSONL conversation logs, this Skill extracts user and assistant messages while intelligently filtering out noise entries like progress updates and internal system metadata. It differentiates content blocks such as text, thinking, and tool uses to isolate the core narrative.

What is the best way to filter noise from LLM logs and extract signal?

Filtering noise from LLM logs is achieved by discarding irrelevant entries such as internal system events and progress updates. The Skill identifies valuable messages and crucial metadata like turn duration, ensuring you only process essential narrative elements from the conversation data.

Can I scan Claude Code conversation files for PII and secrets?

You can scan Claude Code conversation files for PII and secrets using the built-in PII scanning mechanism. This feature flags potential Personally Identifiable Information found within the extracted conversation data, helping maintain security compliance during analysis.

How do I link subagent transcripts to tool uses in Claude Code conversation data?

Linking subagent transcripts to tool uses in Claude Code conversation data is supported through a dedicated subagent linking method. This feature connects main conversation tool uses to their corresponding subagent transcripts, allowing comprehensive tracking of AI decision-making.

Does this conversation parsing approach handle embedded images in JSONL files?

This conversation parsing approach selectively handles embedded images in JSONL files. It extracts content blocks such as text, thinking, and tool uses, with special handling specifically applied to parse and process any embedded image data found within the conversation logs.