recap

Solid

Batch-promote recurring insights from session logs into memory/ files with frequency filtering. Use when the user wants to extract persistent lessons or patterns from recent sessions — 'recap my recent sessions', 'what have I been learning lately'. Do NOT use for: saving a single fact now (use learn), writing today's session log (use wrapup), or synthesizing a specific topic into a note (use distill).

AI & Automation 20 stars 2 forks Updated 5 days ago Apache-2.0

Install

View on GitHub

Quality Score: 81/100

Stars 20%
44
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Recap Batch-promotes insights from session logs into memory/ files. Applies frequency filtering to ensure only recurring insights are promoted. Does NOT write to MEMORY.md — Critical Behaviors are promoted exclusively via /learn. ## Session Log Discovery Glob `[logs_folder]/session/**/*-session-*.md` (post-v2.4.0: session logs live under the dedicated `session/` subfolder); filter to files WITHOUT `recapped:` frontmatter field. Process only those (faster than scanning all logs). If no unrecapped logs found → tell user "No unrecapped session logs found." and stop. ## Run Threshold Read `recap.min_sessions` from `onebrain.yml` (default: `6` if field absent). Read `recap.min_frequency` from `onebrain.yml` (default: `2` if field absent). **1 unrecapped log:** → warn: "Only 1 session log — promotion filter requires at least {min_frequency} sessions." → stop (nothing can pass frequency filter with only 1 log) **2 to (min_sessions - 1) unrecapped logs:** → warn: "{N}/{min_sessions} sessions — below threshold. Recommended to wait for more sessions. Run recap now?" → AskUserQuestion: `run-now / wait` → if `wait`: stop without processing **≥ min_sessions unrecapped logs:** → proceed immediately, no confirmation needed ## Promotion Filter (always applied, regardless of log count) After deciding to proceed, apply frequency filter to all extracted insights: - Promote only insights whose topic appears in ≥ min_frequency of the session logs being processed - Single-occurrence i...

Details

Author
onebrain-ai
Repository
onebrain-ai/onebrain
Created
4 months ago
Last Updated
5 days ago
Language
Shell
License
Apache-2.0

Similar Skills

Semantically similar based on skill content — not just same category