Agent skill

session

Extract conversation turns from AI session history files (.jsonl)

axoviq-aigithub.com/axoviq-aiGitHub ↗
claude-codeships scriptsAGPL-3.0
Install
npx skills add axoviq-ai/synthadoc --skill session --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 4
SKILL.md size: 4 KB
Bundled scripts: yes
Version: 1.0
Declared author: axoviq.com
Path: synthadoc/skills/session/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 857
Language: Python

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# Session Skill Extracts human-readable conversation turns from AI coding session history files (`.jsonl`). Supports two formats: - **Claude Code** — the JSONL format written by Anthropic's Claude Code CLI (`~/.claude/projects/<hash>/<session-id>.jsonl`) - **Codex / Cursor** — the simpler `{"role": ..., "content": ...}` per-line format used by OpenAI Codex and Cursor IDE sessions Format is detected automatically from the first parseable line. ## What gets extracted Only substantive conversation turns are kept: | Content type | Action | |---|---| | User text messages | Kept if ≥ 3 words | | Assistant text responses | Kept if ≥ 20 words | | Assistant thinking blocks | Skipped (internal reasoning, not final output) | | Tool use / tool result blocks | Skipped (avoids leaking file contents or credentials) | | Image / attachment blocks | Skipped | | Sub-agent scaffolding (`isSidechain: true`) | Skipped (internal sub-agent turns) | | Session metadata lines | Skipped (`permission-mode`, `file-history-snapshot`, `system`, `last-prompt`) | The extracted text is then passed through Synthadoc's standard pre-LLM source sanitizer (zero-width characters, bidi overrides, HTML comments, hidden CSS

What's inside
Steps it walks through
  1. What gets extracted
  2. Output format
  3. suggestedslug
  4. Large sessions — chunking
  5. Limitations
  6. When this skill is used
  7. Standalone usage
Ships with 3 files
  • __init__.py
  • scripts/__init__.py
  • scripts/main.py
More from synthadoc
All skills →
About this skill
What does the session skill do?

Extract conversation turns from AI session history files (.jsonl)

How do I install it?

Run `npx skills add axoviq-ai/synthadoc --skill session --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From axoviq-ai/synthadoc, a repository with 857 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going