session-logger
Save a bounded, redacted session summary when the user asks to record a conversation or when a supported host provides an explicit session-end transcript event.
By zhaono1 · 734 installs
npx skills add zhaono1/agent-playbook --skill session-logger
Source repository · Upstream listing
Session Logger
Create a compact recovery artifact without treating raw conversation history as
durable memory.
Use This Skill When
The user explicitly asks to save or record the current session.
A supported host invokes the Agent Playbook SessionEnd hook with a transcript path.
A later task needs a concise handoff artifact and the user has authorized writing it.
Do not silently persist raw transcripts, credentials, private customer data, or
unbounded agent output. Host support and write authority must be visible; skill
metadata alone does not execute a hook.
CLI Runtime Contract
Claude Code installation can invoke:
The command reads the host provided JSONL transcript and stores only bounded,
redacted details:
message counts;
the last user prompt, truncated after redaction;
up to 12 detected commands and file references;
up to 8 detected questions;
a hashed session reference and project identity.
By default, files are private local artifacts:
Set AGENT PLAYBOOK DATA DIR or pass data dir to move the private data root.
Writing inside a repository is opt in only:
If a repository local directory is selected, verify its ignore and retention
policy before writing. Never assume another repository ignores sessions/ .
Manual Summary Contract
When the host cannot provide a transcript event, create a user authorized
summary from the context actually visible in the current session. Include only:
1. outcome and current state;
2. decisions that affect future work;
3. relevant files or commands;
4. open questions and next proof gate.
State omissions honestly. Do not claim full conversation capture, structured
decision extraction, automatic append behavior, or cross session recall unless
the active runtime demonstrably provides it.
Privacy and Safety
Redact common credentials, bearer tokens, private keys, email addresses, and
password/secret assignments before writing.
Replace the current project root with a project identity in generated metadata.
Write generated summaries with owner only permissions where the platform supports it.
Keep the artifact local unless the user separately authorizes commit, upload, or sharing.
Treat redaction as risk reduction, not a guarantee that arbitrary confidential text is safe.
Completion Check
[ ] Destination and write authority are clear.
[ ] The summary is bounded and contains no known raw secret.
[ ] Repository local storage was explicitly selected and ignore policy checked.
[ ] The returned path exists and is readable by the user.