← ClaudeAtlas

conversation-json-to-mdlisted

Use when converting chat export JSON into per-conversation Markdown files with preserved user-assistant Q/A and normalized headings.
YangsonHung/awesome-agent-skills · ★ 17 · Data & Documents · score 78
Install: claude install-skill YangsonHung/awesome-agent-skills
# Conversation JSON To MD ## Overview Convert a user-provided chat-export JSON into multiple Markdown files with consistent Q/A formatting. The workflow keeps only user-assistant exchanges, writes one conversation per Markdown file, preserves answer Markdown, and runs a second pass to normalize filenames and heading structure. ## When to Use Use this skill when the user asks for: - Splitting one JSON chat export into many `.md` files - One conversation per markdown file - Keeping only question/answer content from user and assistant - Renaming response sections to `Answer` - Normalizing exported files with a second formatting pass ## Do not use Do not use this skill for: - Plain text transformation that does not involve JSON chat exports - Non-conversation JSON processing tasks - Requests requiring semantic summarization instead of structural conversion ## Instructions 1. Read the input file path provided by the user. Do not assume default file names. 2. Detect conversation/message structure automatically. 3. Export one markdown file per conversation. 4. Keep only user/assistant Q&A content. 5. Format each Q/A block as: - `## <question text>` - `### Answer` 6. Preserve answer markdown and demote answer-internal heading levels by one level. 7. Run an independent second-pass formatting check and fix naming/title structure before final delivery. ## Supported Input Structures The bundled script supports common export formats including: - DeepSeek/ChatGPT-like mappi