logbook
Skill1 starsChanged 46 days agoMITView on GitHub
Daily logbook of sessions with the orchestrator. Use when the owner asks for "recap of today", "wrap up", "end of day", or whenever it's time to synthesize in writing what was done and what was learned. Writes to the `logbook_path` declared in preferences.
4 other projects use a version of this.
Adopted by
Most recently taken up by
- stradinov/nebtheir own version, first seen Oct 9, 2026
- PapyGaragos/skillstheir own version, first seen Oct 1, 2026
- sethatwood/belaytheir own version, first seen Sep 23, 2026
- DikDns/upi-rpl-laporan-magangtheir own version, first seen Jun 1, 2026
Other versions4 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 4
- DikDns/upi-rpl-laporan-magang★ 4same name
- PapyGaragos/skills★ 2same name
- stradinov/neb★ 1same name
- sethatwood/belay★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository8 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- add-external-appSkill
- agendaSkill
- archiveSkill
- guideSkill
- maintenanceSkill
- translateSkill
- writing-registerSkill
The file
We split this skill into the rules it gives an agent
11 rules. 0 are common, 5 are distinctive, and 6 are very specific to this project.
0
Common
Most of the 4 edited versions we read keep these.
5
Distinctive
This author's own choices. Worth a look.
6
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 18
If the configured folder doesn't exist yet, create it on first write.
- Very specific: line 44
Follow the full markdown discipline in howto/08-markdown-discipline.md: quote YAML values containing : /# /leading special characters, and …
- Distinctive: line 52
Optional closing: if a cross-cutting lesson or reflection emerges, put it at the end as its own section.
- Very specific: line 78
Read the owner's logbook_path and default_language from private/preferences.md.
- Distinctive: line 84
If the channel is unreachable or the GC fails, don't block the logbook: carry on and report it as a minor note at the end.
- Very specific: line 85
No block, or channel: none, means skip this step.
- Distinctive: line 91
When in doubt, ask the owner "Am I writing the logbook for <day X>?" before going on.
- Very specific: line 111
Every row carries scope (null for the mother).
- Distinctive: line 129
If the script is missing or errors out, don't block the logbook: compose the note from the db and the current conversation, and say so as a …
- Very specific: line 134
Write the note at <logbook_path>/YYYY-MM-DD-slug.md, dated to the target day (the day being documented, not the day of writing), in the …
- Very specific: line 143
Before writing the file, pass the finished text through the writing-register skill, which holds the rules in full, then write it.
“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Logbook
This skill writes the daily logbook: one note per day that synthesizes what was done during the collaboration between the owner and the orchestrator.
It is not the owner's personal diary — it's the shared working log.
Where to write
The path comes from private/preferences.md, field logbook_path. If that field is empty, respond to the owner that the logbook is disabled for this instance and offer to enable it by adding a path to preferences.
If the configured folder doesn't exist yet, create it on first write.
Note conventions
Filename
YYYY-MM-DD-slug-kebab-case.md — zero padding on month and day. The slug summarizes the day's dominant theme in 2–4 words. If the day has no dominant theme, something like work-log is fine.
Frontmatter (mandatory)
---
tags: [tag1, tag2, tag3, ...]
description: one-line summary of what the day covered — used to decide relevance in future queries
---Tags are the retrieval index. A daily logbook is multi-theme, so tags are the primary search lever. Rules:
- Flow-form list
[a, b, c]— compact and readable - Cover all axes touched during the day: people, areas, objects/artifacts, actions/types
- Lowercase, multi-word separated by
-(team-review, notteam_revieworTeamReview) - 8 to 20 tags is right for a normal working day
Description is the one-line summary — same pattern as skill descriptions. It enables the orchestrator (or the owner) to know what a past note was about without opening it.
Follow the full markdown discipline in howto/08-markdown-discipline.md: quote YAML values containing : /# /leading special characters, and use [[Wikilinks]] when referencing other notes in an Obsidian vault.
Body
- First body line (after frontmatter): the date in the owner's default language (from preferences). For example, in Italian:
## 19 Aprile 2026. In English:## 19 April 2026. - H1 evocative title: a short title capturing the day's mood or theme. Not bureaucratic. Example in Italian:
# Una giornata di manutenzione e scoperte. In English:# A day of partner escalations and a quiet MCP fix. - Opening paragraph: 1–3 sentences that frame the tone of the day.
- Thematic sections:
### Section titlefor each block of work or discovery. One section = one theme. Don't mix. - Optional closing: if a cross-cutting lesson or reflection emerges, put it at the end as its own section.
Tone and voice
- Voice: the owner's first person. Even though the work was done together with the orchestrator, the logbook is the owner's synthesis of what they wanted to do and what they are learning.
- Tone: narrative, reflective, concrete. Not bureaucratic, not a task list. Each section tries to tell what happened, say why it's interesting, and sometimes close with a lesson or observation in one sentence.
- Language: the owner's default language from preferences. Mix naturally with technical or work-specific English terms where that reflects how the owner actually speaks.
- Avoid:
- Long bullet lists (prefer prose)
- Promotional tone ("amazing!", "incredible!")
- References to "we", "the orchestrator and I", "we did" — stay in first-person singular
- Paraphrasing the memory db logs verbatim — the logbook is a synthesis, not a dump
Sources for composing the note
Build the content from, in order:
- The memory db (
private/memories.db,logtable,date = target day) — complete list of memories, completed tasks, and emerged ideas. It's the one source that already spans every session, because all sessions in the same working directory write to the same file. - The current conversation — context, anecdotes, asides, reflections not in the db
- The other sessions of the target day (
bin/session-digest) — the owner may have worked in parallel across several sessions. Their memories are already in the db; the thread of the discussion is only in their transcripts. See step 5 of the procedure. - Only secondarily: git commits, project-specific sources, calendar, meeting notes
The db is the starting point, not the text of the note. It needs interpretation.
Procedure
- Read the owner's
logbook_pathanddefault_languagefromprivate/preferences.md. Iflogbook_pathis empty, respond that the logbook is disabled and stop. Pre-flush the warm task channel — if
preferences.mddeclares a## Warm task channelblock withchannel != none, invoke the skill named there and run its## Garbage Collectorsection before going on. Writing the logbook is an end-of-session trigger: the flush moves the tasks closed in the warm layer intomemories.dbdated to the target day, so they reach the note instead of staying behind in the task manager. Pattern:howto/07-warm-task-channel.md.- Announce in one line (
📦 archived N tasks: …) only whenN > 0. - Stay silent when the GC is silent (nothing closed, or less than an hour since the last flush).
- If the channel is unreachable or the GC fails, don't block the logbook: carry on and report it as a minor note at the end.
- No block, or
channel: none, means skip this step.
- Announce in one line (
Decide which day you are documenting — the target day is not always today's calendar date. It follows the same early-morning rule that governs every write to
memories.db.- Invoked in the small hours (before 06:00 local) and no logbook exists yet for the previous day → the target day is the previous day. The working session that was lived is one, and it does not split at the change of solar date: it started the evening before and is running into the night. Collecting only the hour or two past midnight would produce a partial note.
- Any other case (from 06:00 on, or a logbook for the previous day already exists) → the target day is today.
- When in doubt, ask the owner "Am I writing the logbook for
<day X>?" before going on.
Retrieve the target day's log entries, mother and satellites together:
bin/mem today --all-scopesFor a target day other than today:
bin/mem today --date <DAY> --all-scopesIn the early-morning case, include the entries of the night that follows (those dated today, up to the moment of the call): they are usually the tail of the same session and belong to the previous day's note.
bin/mem today --date yesterday --to today --all-scopesEvery row carries
scope(null for the mother). Rows withscope: nullfeed the day's themes (step 6). Rows with ascopeset go into a### Satellitessection, grouped by scope, so a satellite's activity stays visible without folding into the mother's own themes.Pick up the threads of the parallel sessions — the owner may have worked across several sessions the same day (agent view). Their memories are already in the db by construction; what's missing is the thread of each discussion, which lives only in its transcript.
bin/session-digest # today bin/session-digest --date yesterday # when the target day is the previous one bin/session-digest --date 2026-08-25 # explicit dayIt returns, for every session with activity that day, the name the owner gave it and the messages they typed, in chronological order. The assistant's replies stay out (they run to megabytes, and the owner's messages are enough to reconstruct what was discussed).
How to use it:
- Read the digest before grouping by theme: it carries the threads the db doesn't record, and session names are often the day's themes already.
- The db stays the source of facts. The digest adds context and nuance, and surfaces open threads whose outcome nobody recorded. When something substantial in the digest is missing from the db, save it as a memory before writing the note, so the next search finds it.
- The current session shows up in the digest too. You already have its context in front of you: use the digest to check it says nothing more, not to reread it.
- Sessions sharing a title with overlapping messages are one conversation seen through two transcripts (backgrounded or forked). The script merges them; if a trace survives, treat them as one.
- If the script is missing or errors out, don't block the logbook: compose the note from the db and the current conversation, and say so as a minor note at the end.
- Group by theme (not by type): multiple entries can merge into a single section if they talk about the same topic. Rows with a
scopedon't enter this grouping — they go into the Satellites section from step 4. - Pick a thread for the H1 if the day has one; otherwise use a neutral title like
# Work log. - Extract tags — from entries, conversational asides, and the parallel sessions — and draft a one-line
description. - Write the note at
<logbook_path>/YYYY-MM-DD-slug.md, dated to the target day (the day being documented, not the day of writing), in the owner's default language. - Confirm to the owner: path written + tags chosen + the target day, when it differs from today + how many sessions fed into it, when more than one.
If a note for the target day already exists, do not overwrite. Ask the owner whether to update it (append a new section) or create a second note with a different slug.
Writing register
Domain: documentation, with one override: the logbook keeps the owner's first-person narrative and the evocative title described above, so tone_default.documentation and the voice line don't apply here. Prohibition 7 is the one a logbook trips over most, because a daily note invites a closing verdict: "solid progress on the parser" goes, "the parser now handles empty input, the timeout is still missing" stays. A reflective closing section is welcome when it carries an observation.
Before writing the file, pass the finished text through the writing-register skill, which holds the rules in full, then write it. Delivery is silent: confirm the path and the tags to the owner, without narrating what the pass changed.
When to trigger
The owner usually invokes this skill explicitly with phrases like:
- "Recap of today"
- "Wrap up the day"
- "Update the logbook"
- "End of day"
- "Let's take stock"
The skill may also be suggested by the orchestrator when the conversation reaches a natural closing point and the day has produced enough material to summarize — but only as a suggestion, never autonomously.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

