Extract insights from transcripts into actionable artifact files.
Process raw transcript logs and extract insights directly into artifact 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 |
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
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):
Loose ends (loose-ends.md):
Research backlog (research-backlog.md):
Blog grist (blog-grist.md):
Memories (things-learned.md):
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'.
After extracting insights from a session:
uv run --project ~/.claude/skills/digest digest mark <session_id>
Brief summary:
Keep it short. The artifacts speak for themselves.