parse-cowork-session

Convert claude-cowork session JSONL exports into readable markdown transcripts.

Updated May 6, 2026
One-click install
npx skills add https://github.com/Takfes/indie-scaffolder --skill parse-cowork-session
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: parse-cowork-session
Source: https://github.com/Takfes/indie-scaffolder/tree/main/components/agent-skills-commands/.agents/skills/parse-cowork-session
Command: npx skills add https://github.com/Takfes/indie-scaffolder --skill parse-cowork-session

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill converts claude-cowork session exports into clean markdown transcripts, making noisy JSONL chat logs easy to read, share, and review.

Core Features & Use Cases

  • Transcript Rendering: Extracts only the meaningful user and assistant turns from a claude-cowork export.
  • Noise Filtering: Skips session metadata, attachment records, and tool-response payloads so the output stays readable.
  • Optional File Output: Saves the parsed conversation as markdown or prints it inline for quick inspection.
  • Use Case: Use it when you exported a cowork session and want the conversation turned into a polished markdown log for review or documentation.

Quick Start

Ask me to parse your claude-cowork export and provide the path to the JSONL file so I can turn it into a markdown transcript.

Frequently Asked Questions about parse-cowork-session

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

FAQPage Schema
How do I convert a claude-cowork JSONL export into a readable markdown transcript?

Parsing a cowork session JSONL file involves filtering out session metadata, attachment records, and tool-response payloads to isolate user and assistant turns. A bundled Python parser processes the chat log and optionally writes the cleaned conversation as a markdown output file for documentation.

What is the best way to clean chat logs and remove tool-use noise from a session export?

The best way to clean chat logs is to use a parsing script that skips session metadata, attachment records, and tool-response payloads. By filtering this noise, the parser isolates the core user and assistant turns, producing a polished markdown transcript that is easy to share and review.

Does the transcript parser work with UUID-named JSONL files from cowork sessions?

Yes, the transcript parser processes UUID-named JSONL files specifically from claude-cowork session exports. It reads the chat log structure, filters out tool-response payloads and metadata, and extracts the preserved user and assistant turns for markdown rendering.

Can I print a parsed chat log inline instead of saving it as a markdown file?

Yes, you can print the parsed chat log inline for quick inspection instead of writing a markdown output file. The parser offers optional file output, letting you choose between saving the rendered conversation as markdown or displaying the cleaned transcript directly in your console.

What types of records are skipped when rendering a cowork session transcript?

When rendering a cowork session transcript, the parser skips session metadata, attachment records, and tool-response payloads. Filtering these records from the JSONL chat log ensures the markdown output preserves only the meaningful user and assistant turns, keeping the final transcript clean and readable.