From skill-eval
Extract structured events from Claude Code session transcripts into normalized JSONL format. Parses user messages, tool_use blocks, tool results, thinking blocks, errors, progress events, and subagent transcripts.
How this skill is triggered — by the user, by Claude, or both
Slash command
/skill-eval:transcript-extractThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Extract structured, machine-readable events from Claude Code session transcripts stored in `~/.claude/projects/`.
Extract structured, machine-readable events from Claude Code session transcripts stored in ~/.claude/projects/.
# Extract all sessions from last 7 days
bun scripts/transcript-extract.ts --since 7d -o events.jsonl
# Extract a single session by UUID
bun scripts/transcript-extract.ts --session <uuid> -o events.jsonl
# Filter by project slug
bun scripts/transcript-extract.ts --project my-project --since 3d -o events.jsonl
# Include subagent transcripts
bun scripts/transcript-extract.ts --since 7d --include-subagents -o events.jsonl
# Output summary stats instead of JSONL
bun scripts/transcript-extract.ts --since 7d --format summary
# Pipe single session to jq
bun scripts/transcript-extract.ts --session abc-123 | jq '.type'
| Flag | Description |
|---|---|
--session <uuid> | Extract a single session by UUID |
--project <slug> | Filter by project slug |
--since <duration> | Only sessions modified in last N (e.g. 7d, 24h, 30m) |
--include-subagents | Also extract subagent transcripts |
--output, -o <file> | Output file (default: stdout) |
--format <format> | jsonl (default) or summary |
--help | Show help |
~/.claude/projects/ directly)Each line in the output JSONL is a normalized event. Event types: user_message, assistant_text, tool_use, tool_result, thinking, progress, system.
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub asragab/asragab-claude-marketplace --plugin skill-eval