Transcript Scraper

How Skilltrace reads your session activity without touching your context.

Overview

The transcript scraper reads Claude Code's session transcript files to understand what happened during your session. It feeds structured data to the skill checker agent.

What Gets Read

  • User prompts and assistant responses
  • Tool calls (file reads, writes, edits, bash commands)
  • Tool results and error outputs
  • Session metadata (project directory, timestamps)

What Gets Ignored

  • System prompts and internal messages
  • Hook outputs from other plugins
  • File contents beyond what's needed for skill extraction

Privacy

The transcript scraper operates entirely locally. No data leaves your machine. Transcripts are read from Claude Code's local storage and processed in-memory.

Implementation

Parses JSONL transcript files, extracts relevant turns, and provides a structured view to the skill checker agent.

The scraper is incremental and only processes new activity, keeping overhead minimal even in long sessions.