exporting-conversation

Convert wizard session JSON into structured Markdown documentation files.

1|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/SpillwaveSolutions/codebase-mentor --skill exporting-conversation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: exporting-conversation
Source: https://github.com/SpillwaveSolutions/codebase-mentor/tree/main/plugins/codebase-wizard/skills/exporting-conversation
Command: npx skills add https://github.com/SpillwaveSolutions/codebase-mentor --skill exporting-conversation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Synthesizes raw wizard session JSON into structured documentation, enabling easy sharing, archival, and reference.

Core Features & Use Cases

  • Converts raw wizard session JSON into structured documentation (SESSION-TRANSCRIPT.md, CODEBASE.md, TOUR.md, and FILE-NOTES.md).
  • Supports exporting a single session, the latest session, or all sessions, organizing outputs under {resolved_storage}/docs/{session_id}/.
  • Validates the session JSON schema and generates per-mode outputs: describe mode produces CODEBASE.md, explore mode produces TOUR.md, and file mode produces FILE-NOTES.md.
  • Preserves an auditable transcript in SESSION-TRANSCRIPT.md with Q&A turns and references.

Quick Start

Run the /codebase-wizard-export command to synthesize the latest session into SESSION-TRANSCRIPT.md and the appropriate Markdown docs in the docs folder.

Frequently Asked Questions about exporting-conversation

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

FAQPage Schema
How do I convert wizard session JSON into Markdown documentation?

You can export wizard sessions by running the export command, which validates the session JSON schema and generates structured Markdown files such as SESSION-TRANSCRIPT.md, CODEBASE.md, TOUR.md, and FILE-NOTES.md in the docs folder.

What Markdown files are generated when exporting explore or file mode sessions?

Exporting explore mode sessions generates TOUR.md, while file mode sessions produce FILE-NOTES.md. Describe mode generates CODEBASE.md. All exports include a SESSION-TRANSCRIPT.md preserving Q&A turns and references for auditable archival.

Can I export all stored wizard sessions at once instead of just the latest?

Yes, the export supports all sessions, the latest session, or a single session. It reads the stored wizard session history and organizes the resulting structured documentation outputs under their corresponding session_id directories.

Does the export process validate the JSON schema before generating docs?

The export process validates the session JSON against the expected schema version 1 before generating documentation. This ensures raw wizard session data matches the required structure before writing outputs to the docs directory.

What happens if my session JSON does not match schema version 1?

If the session JSON does not match the expected schema version 1, the validation step will fail. The Skill requires the correct schema to successfully read the session history and write the structured Markdown documentation outputs.