Our review

Extracts actionable insights from transcript logs and organizes them into structured artifact files.

Strengths

Automatically categorizes insights into multiple files (opportunities, loose ends, etc.)
Includes source session references for full traceability
Simple CLI with dedicated commands (list, extract, note, mark)
Handles timestamps and note formatting automatically

Limitations

Requires a specific transcript format with session IDs
Manual marking of processed sessions can be forgotten
Only processes already recorded transcripts, not live streaming

When to use it

After a conversation session to capture key ideas, action items, and learnings.

When not to use it

When transcripts are not available in the expected format or you need real-time note-taking.

Examples

Process latest transcript

Run the digest skill on the latest transcript session. First list unprocessed sessions, then extract insights from the newest one, and add notable entries to opportunities and loose ends files.

Extract and note specific session

Use digest to process session abc123: extract its content, add any research ideas to research-backlog.md, and mark the session as processed.

Bulk extract all new transcripts

Run digest list to see unprocessed sessions, then extract each one and add findings to the appropriate artifact files. Report a summary of what was added.

name: digest description: Extract insights from transcripts into actionable artifact files.

/digest

Process raw transcript logs and extract insights directly into artifact files.

Output Files

All in notes/digest/:

| File | What to extract | |------|-----------------| | opportunities.md | Optimization ideas - "could improve", friction points, repeated manual work, better approaches mentioned | | loose-ends.md | Open items - TODOs not done, questions unanswered, "need to" without resolution | | research-backlog.md | Future directions - "interesting", "worth exploring", novel techniques | | blog-grist.md | Significant work completed, problems solved, patterns discovered | | things-learned.md | Preferences, environment facts, workflow learnings |

Instructions

1. Find unprocessed transcripts

uv run --project ~/.claude/skills/digest digest list

If output is "Nothing new to process", stop here.

Use --path <dir> to specify a different base directory (defaults to cwd):

uv run --project ~/.claude/skills/digest digest --path /other/project list

2. Extract and analyze

For each session with new content:

uv run --project ~/.claude/skills/digest digest extract <session_id>

This outputs cleaned message text (user/assistant only, no metadata).

What to look for (include source ref [session_id:line] for each item):

Opportunities (opportunities.md):

"could improve", "should optimize", "better way"
Friction, repeated steps, workarounds
Failed approaches that revealed a gap

Loose ends (loose-ends.md):

TODOs not completed in the session
Questions raised but not answered
"Need to" / "should" without resolution

Research backlog (research-backlog.md):

"Interesting", "worth exploring"
Techniques mentioned but not tried
Links/references saved for later

Blog grist (blog-grist.md):

Significant work completed
Problems solved in interesting ways
Patterns or insights that emerged

Memories (things-learned.md):

User preferences ("I prefer...", "don't like...")
Environment facts (paths, configs, tools)
Workflow patterns to remember

3. Add notes

Use the note command to add entries. It handles timestamp and formatting automatically:

uv run --project ~/.claude/skills/digest digest note notes/digest/opportunities.md --project "project-name" "- Insight here [session_id:line]"

Or pipe multiple lines:

echo "- First insight [abc123:42]
- Second insight [abc123:55]" | uv run --project ~/.claude/skills/digest digest note notes/digest/opportunities.md --project "myproject"

The CLI prepends entries with a timestamp from date '+%Y-%m-%d %H:%M'.

4. Mark processed

After extracting insights from a session:

uv run --project ~/.claude/skills/digest digest mark <session_id>

5. Report

Brief summary:

Sessions processed: N (X new lines)
Items added: Y opportunities, Z loose ends, etc.

Keep it short. The artifacts speak for themselves.

Extract insights from transcripts

Recommended for