distill-skill

Distill Skill — Session → Skill

Record a CC session, then distill it into a generalized skill via edit-tool. Two modes: forward (record as we go) and retrospective (parse session-so-far).

Modes

Workflow

1. start — initialize trace

: "${PRAXIS_DIR:?PRAXIS_DIR must be set}"
SID=$(date -Iseconds | tr ':+' '-')
DIR="$PRAXIS_DIR/.tmp/distill-skill/$SID"
mkdir -p "$DIR"
echo "$DIR" > "$PRAXIS_DIR/.tmp/distill-skill/.current"

Create three files in $DIR:

• trace.jsonl — append-only per-turn: {ts, turn, user_intent, tools_used, files_touched, outcome, friction?, confusion_flag?}
• draft.yaml — RISEN-lite scaffold (see reference.md)
• anti-patterns.md — what didn't work + why

Respond: 🎬 Recording to $DIR. Annotate turns as you go. /distill-skill finalize when done.

2. Annotate each turn

After each meaningful turn, append to trace.jsonl — fields: user_intent (generalized, not verbatim) · tools_used · files_touched · outcome ∈ {ok,retry,abandoned} · friction (verbatim correction, if any) · confusion_flag (true if assistant asked clarifying Q → signals upfront disambiguation needed).

Keep draft.yaml filled progressively as evidence accumulates.

3. finalize — distill

1. Compaction check (retrospective only): turn >30 or early context lost → warn, confirm start-of-session facts first.
2. Generalize: trace.jsonl + draft.yaml → strip session-specifics.
3. Dedup: /search-skill <intent> → report overlap verdict. Mandatory.
4. Split: ≥2 distinct end-goals with disjoint tools/inputs → propose split, confirm.
5. Preload scan: Glob $PRAXIS_DIR/reference/ for frameworks referenced → list as @include candidates.
6. Handoff: /edit-tool with draft.yaml + anti-patterns.md → it triages (skill/bash/agent) and writes. Never write final skill directly.
7. Kaizen: each retry-friction → append to $PRAXIS_DIR/thinking/kaizen/distill-skill.jsonl.