se-session-extract

Extract skeleton digests or error reports from session JSONL files.

Updated May 7, 2026
One-click install
npx skills add https://github.com/simonwjackson/pi-software-engineering --skill se-session-extract
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: se-session-extract
Source: https://github.com/simonwjackson/pi-software-engineering/tree/main/skills/se-session-extract
Command: npx skills add https://github.com/simonwjackson/pi-software-engineering --skill se-session-extract

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Large session JSONL files contain rich transcripts but are often too big to load into context. This Skill provides lightweight extraction of relevant narrative skeletons or error signals to support focused analysis.

Core Features & Use Cases

  • Extract a conversation skeleton: a concise narrative of user/assistant turns and collapsed tool-call summaries.
  • Extract error signals: identify and surface tool errors or failures from a session file for quick diagnosis.
  • Use case: Analysts load one or more session JSONL files and need compact digests to feed AI agents without exposing full transcripts.

Quick Start

Run the extractor on a session.jsonl file to obtain either a skeleton or error digest.

Frequently Asked Questions about se-session-extract

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

FAQPage Schema
How do I extract a conversation skeleton from large session JSONL files?

You can extract a conversation skeleton from large session JSONL files by running the skeleton extraction script, which generates a concise narrative digest of user and assistant turns with collapsed tool-call summaries for lightweight analysis.

How do I identify tool errors in session data for quick diagnosis?

To identify tool errors in session data, run the error extraction mode to surface tool errors and failures directly from the JSONL file, outputting a focused error report alongside a meta summary of error counts for quick diagnosis.

What is the best way to reduce JSONL session file size for AI context windows?

The best way to reduce JSONL session file size for AI context windows is to extract lightweight narrative skeletons or error signals, producing compact digests that feed AI agents without exposing the full transcript.

Can I extract both error signals and conversation summaries from the same JSONL file?

Yes, you can extract both error signals and conversation summaries from the same JSONL file by running the skeleton and error extraction modes independently, each producing a distinct digest with a meta summary of relevant counts.

Does this session extraction tool require external dependencies to process JSONL data?

No, this session extraction tool requires no external dependencies to process JSONL data, relying entirely on deterministic extraction logic built into its Python scripts to generate skeleton digests and error reports.