log-visualiser-converter

Convert Claude Code JSONL session logs into enriched visualiser JSON files.

2|1|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/timgranlundmarsden/claude-agent-flow --skill log-visualiser-converter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: log-visualiser-converter
Source: https://github.com/timgranlundmarsden/claude-agent-flow/tree/main/skills/log-visualiser-converter
Command: npx skills add https://github.com/timgranlundmarsden/claude-agent-flow --skill log-visualiser-converter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns raw Claude Code session logs into a clean, publishable visualiser JSON file, saving you from manual log editing and reducing the risk of broken or exposed output.

Core Features & Use Cases

  • Session Log Conversion: Builds a base visualiser file from Claude Code JSONL session data.
  • Narrative Enrichment: Repairs agent models, converts brainstorming prompts into structured questions, and corrects adversarial loop transitions so the playback reads clearly.
  • Publishing Safety: Sanitizes sensitive paths, usernames, repo names, session URLs, and other identifiers before the log is saved for public viewing.
  • Use Case: Prepare a development session for a docs site by turning a messy runtime transcript into a story-driven log with accurate timing, phase markers, and review outcomes.

Quick Start

Run the log visualiser converter for your Claude Code session by providing a log id, title, and subtitle so it can generate the enriched visualiser JSON file.

Frequently Asked Questions about log-visualiser-converter

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

FAQPage Schema
How do I convert a Claude Code session JSONL log into a visualiser JSON file?

To convert a Claude Code session JSONL log, you parse the raw session data and transform it into an enriched visualiser JSON file. This process repairs agent models and converts prompts into structured questions for clear playback.

Does Claude Code log conversion sanitize PII before publishing?

Claude Code log conversion mandates PII sanitization before saving the visualiser JSON file. It scrubs sensitive paths, usernames, repo names, and session URLs to ensure the output is safe for public viewing.

Can I adjust timing and transitions for adversarial review loops in session logs?

You can adjust timing and correct adversarial loop transitions during JSONL log conversion. The process validates transitions and applies timing adjustments so the final visualiser file reads clearly as a story.

What is the best way to prepare a raw runtime transcript for a docs site?

The best way to prepare a raw runtime transcript for a docs site is to run it through a log visualiser converter. This generates a story-driven JSON file with accurate timing, phase markers, and review outcomes ready for publication.

Do I need to provide a log id and title for Claude Code session log conversion?

You need to provide a log id, title, and subtitle to run the log visualiser converter for your Claude Code session. These inputs allow the tool to generate the enriched visualiser JSON file.

Why does my Claude Code session log playback read poorly as a narrative?

Your Claude Code session log playback reads poorly because raw JSONL logs lack narrative structure. Converting the log repairs agent models and structures brainstorming prompts into questions, creating a story-focused visual experience.