What is transcript-distillation?

A workflow for turning coding-agent conversation logs into rows for training or evaluating AI models.

Use it to process Claude Code or Codex logs, extract assistant turns, label their quality, score sessions by outcomes such as passing tests, and create SFT, KTO, DPO, or GRPO datasets.

It removes the manual work of reading transcripts, removing secrets and filler, and judging which exchanges were useful.

How ProfSynapse/Synaptic-Tuner configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to ProfSynapse/Synaptic-Tuner. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/ProfSynapse/Synaptic-Tuner/main/.agents/skills/transcript-distillation/SKILL.md

Clone the repo

git clone --depth 1 https://github.com/ProfSynapse/Synaptic-Tuner

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/profsynapse/synaptic-tuner/transcript-distillation/github.svg)](https://agentmods.dev/skills/profsynapse/synaptic-tuner/transcript-distillation)

Your own site

<a href="https://agentmods.dev/skills/profsynapse/synaptic-tuner/transcript-distillation"><img src="https://agentmods.dev/badge/skills/profsynapse/synaptic-tuner/transcript-distillation/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/profsynapse/synaptic-tuner/transcript-distillation"><img src="https://agentmods.dev/badge/skills/profsynapse/synaptic-tuner/transcript-distillation.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 136 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,727 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits

NVIDIA SkillSpector pass 7 Sept 2026

How audits are shown

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00136	$0.01727
Opus 5.5	$0.00054	$0.00691
Sonnet 5.5	$0.00027	$0.00345
Haiku 4.5	$0.00014	$0.00173

Measured 1mo ago against content hash 9d1724266d1c, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

transcript-distillation scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

The scan reads SKILL.md. This mod also ships 7 executable files (scripts/adapters/__init__.py, scripts/adapters/base.py, scripts/adapters/claude_code.py, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/transcript-distillation/SKILL.md · 144 lines

How it starts

The opening of the file, as written. The whole thing — 144 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Transcript Distillation

Mine local agent transcripts into training data. You point it at a directory of conversation logs; it emits one row per assistant turn, scrubs secrets, labels each turn (accept / borderline / reject), scores each session by how it ended up (tests passed, clean build, commit, PR, approval), drops ceremony/filler/ duplicates, and stamps a quality tier (gold/silver/bronze) on every row.

Format-agnostic. The engine knows nothing about Claude or Codex — that lives in small pluggable adapters. Two ship built-in (claude_code, codex); add more in ~40 lines (see reference/writing-adapters.md).

Quickstart

SKILL=.skills/transcript-distillation

# 1. copy the template config and (optionally) edit scope/paths
cp $SKILL/configs/template.yaml my_distill.yaml

# 2. smoke test on a few files first — ALWAYS do this before a full run
python $SKILL/scripts/distill.py --config my_distill.yaml --smoke --limit 20 --show 3

# 3. full run
python $SKILL/scripts/distill.py --config my_distill.yaml

Out of the box the template grabs all local Claude Code (~/.claude/projects) and Codex (~/.codex/sessions) transcripts and writes to ./transcript_distill_out/rows.jsonl. Only dependency: pyyaml.

CLI

Flag	Meaning
`--config PATH`	distill config YAML (required)
`--smoke`	write to a `smoke/` subdir (keeps full runs separate)
`--limit N`	cap files per source (0 = all) — use for smoke tests
`--sources a,b`	restrict to named sources from config
`--show N`	print N sample rows to eyeball quality
`--max-context-tokens N`	override `context_budget.max_context_tokens` for this run

Pipeline (all config-driven)

adapter.parse(file)            # format-specific -> normalized events
  -> one row per assistant turn
  -> secret scrub at emit time (raw secrets never hit disk)
  -> context filled most-recent-first under a TOKEN budget
  -> deterministic label: accept / borderline(->judge) / reject
  -> quality funnel: drop ceremony tools, trivial filler, duplicates
  -> session-outcome tiering: gold / silver / bronze
  -> JSONL

Read the full file on GitHub · 144 lines

Files

What ships with it

11 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

1mo ago Changed · +7 lines 9d1724266d1c
2mo ago First seen · 137 lines · 136 tokens per session scan A a701fa3e6d6b

Subscribe to this mod's changes

transcript-distillation is a skill published in the GitHub repository ProfSynapse/Synaptic-Tuner (28 stars, last pushed 3d ago), licensed MIT. It adds 136 tokens to every session and 1,727 once invoked, about $0.0005 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Data and AI

transcript-distillation next to 6 skills from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
transcript-distillationProfSynapse/Synaptic-Tuner	Skill	28	3d ago	MIT	A	136	Claude Code
agent-platform-model-registrygoogle/skills	Skill	22k	yesterday	Apache-2.0	A	60	Claude Code, Codex
foundry-config-setupmicrosoft/agent-framework	Skill	15k	yesterday	MIT	A	65	Claude Code, Codex
google-cloud-solution-agentic-analytics-spark-knowledge-cataloggoogle/skills	Skill	22k	yesterday	Apache-2.0	A	132	Claude Code, Codex
training-checkwanshuiyin/Auto-claude-code-research-in-sleep	Skill	19k	3d ago	MIT	A	35	Claude Code
nemo-automodel-launcher-configNVIDIA/skills	Skill	3.9k	yesterday	Apache-2.0	A	30	Claude Code
finetuningmicrosoft/skills	Skill	3.2k	yesterday	MIT	A	132	Claude Code

Synaptic-Tuner: Skill for Claude Code