ALWAYS use this skill instead of Read when reading Claude Code transcript files (.jsonl in ~/.claude/projects/, ~/.claude/history.jsonl, or paths containing 'transcript'). Token-efficient format that extracts USER/ASSISTANT exchanges and tool summaries, strips metadata.
From agentic-coding-toolsnpx claudepluginhub thesylvester/agentic-coding-tools --plugin read-transcriptThis skill is limited to using the following tools:
scripts/read-transcriptSearches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.
Guides idea refinement into designs: explores context, asks questions one-by-one, proposes approaches, presents sections for approval, writes/review specs before coding.
Token-efficient reader for Claude Code .jsonl transcript files. Strips metadata, extracts conversation flow.
CRITICAL: Use this skill AUTOMATICALLY instead of Read for any transcript files.
File Patterns:
~/.claude/projects/*/<UUID>.jsonl - main session transcripts~/.claude/projects/*/agent-*.jsonl - sub-agent transcripts (at project root)~/.claude/projects/*/<UUID>/subagents/agent-*.jsonl - nested sub-agent transcripts~/.claude/history.jsonl - ⚠️ command history (different format, not supported)*/diffs/*/transcript_cycle.jsonl - transcript cycle files.jsonl when context suggests Claude Code conversationUser Phrases:
Only use Read directly if:
# Basic - outputs to stdout
.claude/skills/read-transcript/scripts/read-transcript /path/to/transcript.jsonl
# With metadata header (dir, branch, timestamps, entry count)
.claude/skills/read-transcript/scripts/read-transcript transcript.jsonl --summary
# Text only (no tool calls)
.claude/skills/read-transcript/scripts/read-transcript transcript.jsonl --no-tools
# Compact format
.claude/skills/read-transcript/scripts/read-transcript transcript.jsonl --compact
# Include sub-agent transcripts inline
.claude/skills/read-transcript/scripts/read-transcript transcript.jsonl --inline-subagents
# Pagination (like Read tool's offset/limit)
.claude/skills/read-transcript/scripts/read-transcript transcript.jsonl --offset 10 --limit 5
| Flag | Description |
|---|---|
--summary | Include metadata header (dir, branch, timestamps) |
--no-tools | Omit tool calls/results (text exchanges only) |
--compact | Denser output format |
--inline-subagents | Recursively inline sub-agent transcripts |
--thinking | Include thinking blocks (usually skip to save tokens) |
--offset N | Skip first N entries (0-based, like Read tool) |
--limit N | Return only N entries (like Read tool) |
Auto-trigger on:
.jsonl file in ~/.claude/projects/Also useful for:
Supports Read-like pagination for large transcripts:
# Entries 10-14 (0-based indexing)
.claude/skills/read-transcript/scripts/read-transcript transcript.jsonl --offset 10 --limit 5 --summary
# Output: "Entries: 5 (showing 10-14 of 745)"
Use --summary with pagination to see the range displayed.