skills.rest
jnotsknab
jnotsknabCOMMUNITY
Explore all skills by this author →
GitHub

session-reader

Summarize Mux session directories into Markdown reports with per-agent activity.

6|Updated Mar 6, 2026
Search Tags:#markdown#logs#analysis#agents#artifacts#session#summarize
One-click install
npx skills add https://github.com/jnotsknab/mux-swarm --skill session-reader-jnotsknab
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: session-reader
Source: https://github.com/jnotsknab/mux-swarm/tree/main/Skills/bundled-docker/session-reader
Command: npx skills add https://github.com/jnotsknab/mux-swarm --skill session-reader-jnotsknab

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill summarizes one or more Mux session folders into a clean Markdown report, giving you fast context at task start and a clear review of tool usage, delegated agents, artifacts, and outcomes across sessions.

Core Features & Use Cases

  • Summarize one or more session directories into a Markdown report with a single command.
  • Identify session type (swarm vs chat) by the number and structure of session files, and present per-agent activity including tool calls, delegations, artifacts, and outcomes.
  • Enable quick comparison across multiple sessions to accelerate planning and review.

Quick Start

Run the summarize_session.py script against one or more session directories to generate a Markdown session report.

Frequently Asked Questions about session-reader

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

FAQPage Schema
How do I summarize agent session logs into a readable report?▼

You can summarize agent session logs into a readable report by running a Python script against one or more Mux session directories to consolidate tool usage, delegations, artifacts, and outcomes into a single Markdown file.

What is the best way to analyze multi-agent swarm session artifacts?▼

Analyzing multi-agent swarm session artifacts is done by reading swarm and chat session JSON files to identify the session type and extract per-agent activity, producing a consolidated Markdown summary for quick review.

Can I compare outcomes across multiple session directories at once?▼

Yes, you can compare outcomes across multiple session directories at once by summarizing one or more session folders together, enabling quick comparison across sessions to accelerate planning and review.

How does a session summarizer identify chat versus swarm sessions?▼

A session summarizer identifies chat versus swarm sessions by analyzing the number and structure of session files within the directory, allowing it to accurately present per-agent activity based on the detected session type.

Do I need external dependencies to generate a Markdown report from session JSON files?▼

You do not need external dependencies to generate a Markdown report from session JSON files, as the summarization script operates standalone without requiring any additional packages or libraries.

What information is included in a Markdown session analysis report?▼

A Markdown session analysis report includes per-agent summaries detailing tool calls, delegated agents, generated artifacts, and final outcomes, providing fast context and a clear review of session activities.

Related Skills

Explore More Software Engineering Skills→
Entropy1110Entropy1110
3

Mali Report Generation

Generate markdown vulnerability analysis reports from session outputs.

Community
Basic
allenaiallenai
30

Asta Artifacts

Export and organize research artifacts into markdown or HTML formats.

Official
Basic
gmelligmelli
1

aget-wind-down

End AGET agent sessions and capture session state, summary, and pending work.

Community
Intermediate
oddshipoddship
3

session-analysis

Parse Pi session JSONL files with jq to extract metrics and tool usage.

Official
Intermediate