Claude Code skill for sharing conversation transcripts via GitHub Gist

SKILL.md

name	description
share-transcript	Share a Claude Code conversation as a public HTML transcript. Use when asked to share, export, or publish the current conversation or a recent session.

Share Transcript

Share a Claude Code conversation as a mobile-friendly HTML transcript via GitHub Gist.

Usage

• "share this conversation" → Upload current session and return shareable URL
• "share transcript" → Same as above
• "export conversation" → Same as above

Instructions

1. Find the current session file

The current session ID is in the scratchpad path. Extract it and find the session file:

# Session files are stored by project path
ls -lt ~/.claude/projects/-Users-linuz90-fab-dev/*.jsonl | head -1

The most recent .jsonl file is typically the current session.

2. Convert and upload to Gist

Use uvx to run the claude-code-transcripts tool with the json command:

uvx claude-code-transcripts json <session-file.jsonl> --gist

This will:

• Convert the session to clean, mobile-friendly HTML with pagination
• Upload to GitHub Gist
• Return a shareable gisthost.github.io URL

3. Return the URL

After the command completes, extract the Preview: URL from the output and share it with the user.

The URL format will be: https://gisthost.github.io/?<gist-id>/index.html

Notes

• Requires gh CLI to be authenticated for Gist uploads
• Sessions are stored in ~/.claude/projects/<project-path>/
• The generated HTML includes an index page and paginated content pages
• The local command requires an interactive terminal, so use json command instead