session
Extract conversation turns from AI session history files (.jsonl)
npx skills add axoviq-ai/synthadoc --skill session --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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 gets extracted
- Output format
- suggestedslug
- Large sessions — chunking
- Limitations
- When this skill is used
- Standalone usage
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.
