jsonl-converter

Convert Claude JSONL session logs into readable Markdown documents.

Updated Jan 19, 2026
One-click install
npx skills add https://github.com/xdaicode/skills --skill jsonl-converter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jsonl-converter
Source: https://github.com/xdaicode/skills/tree/main
Command: npx skills add https://github.com/xdaicode/skills --skill jsonl-converter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claude JSONL session logs are often hard to read, share, and reuse for training or documentation. This Skill converts those logs into clean, readable Markdown documents that preserve conversations, timestamps, and important context.

Core Features & Use Cases

  • Extract complete conversations by parsing each JSONL line (user and assistant messages)
  • Format content into well-structured Markdown with clear timestamps and readable content
  • UTF-8 support to handle Chinese characters, emojis, and other special symbols
  • Available as a CLI tool or Claude Skill for flexible usage
  • No external dependencies; relies on the Python standard library
  • Use cases include reviewing agent behavior, creating knowledge artifacts, and archiving conversations

Quick Start

Provide a path to a .jsonl file (for example, d:/AI/agent.jsonl) to generate a readable Markdown document.

Frequently Asked Questions about jsonl-converter

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

FAQPage Schema
How do I convert Claude JSONL logs to Markdown?

You convert Claude JSONL logs to Markdown by providing the file path to this converter, which parses each JSONL line and outputs a readable document preserving conversations and timestamps.

What is the best way to read and share Claude JSONL session logs?

The best way to share Claude JSONL session logs is converting them into clean Markdown documents that preserve conversations, timestamps, and context for easy review and collaboration.

Can I convert JSONL files with UTF-8 characters and emojis to Markdown?

Yes, you can convert JSONL files containing UTF-8 characters, emojis, and Chinese symbols to Markdown because the converter relies on the Python standard library with full UTF-8 support.

Do I need external Python dependencies to parse JSONL logs into Markdown?

No, you do not need external dependencies to parse JSONL logs into Markdown. The tool runs as a Python CLI or Claude Skill relying entirely on the Python standard library.

How do I extract complete conversations from JSONL session logs?

You extract complete conversations from JSONL session logs by running the converter on your file, which parses user and assistant messages line by line and formats them into structured Markdown.