Session to meeting log
Skill wei18/apple-dev-skills/collaboration-skills/skills/session-to-meeting-log
Read a Claude Code session JSONL log and produce a clean timeline-style meeting log at `meetings/{YYYY-MM-DD}_{topic}.md`. Invoke when the user asks "turn this session into a meeting log", "archive today's discussion", "extract a meeting record from jsonl", or when wrapping up a working session before context window rolls.From its SKILL.md
npx -y skills add wei18/apple-dev-skills --skill session-to-meeting-logAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 18 stars18 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
4.2 KB, 939 tokens by cl100k_base, as published. Nobody here has run it
Session → Meeting Log
When to invoke
- The user says "turn this session into a meeting log" or "archive today's discussion".
- The session is approaching the context limit and needs a written artifact.
- The user mentions "extract notes from
~/.claude/projects/.../*.jsonl". - A long, multi-turn discussion is wrapping up before switching sessions.
Inputs
Locating the session file
- Default location:
~/.claude/projects/<encoded-project-path>/<sessionId>.jsonl <encoded-project-path>: replace/in the absolute path with-, e.g./Users/alice/GitHub/MyOrg/my-project→-Users-alice-GitHub-MyOrg-my-project.<sessionId>: a UUID-like string, either supplied by the user or inferred from the most recent mtime in the directory.- If the user doesn't supply one, list the files in the directory, sort by mtime, and confirm the latest one.
JSONL structure
One JSON event per line; common type fields:
| type | Content |
|---|---|
user | User prompt (incl. system reminders) |
assistant | Assistant response (incl. tool_use blocks) |
tool_result | Tool execution result |
summary | Session summary (if any) |
Key fields: timestamp, message.content, message.role, uuid, parentUuid.
Output
Write to meetings/{YYYY-MM-DD}_{topic}.md:
# {YYYY-MM-DD} — {Topic}
Session id: `<sessionId>`
Mode: <e.g. AI Collaboration Mode (Leader/Developer)>
## Goal
<one-line statement of the session's goal>
## Decisions
1. <decision 1>
2. <decision 2>
## Rejected alternatives
- <rejected option> — reason: <reason>
## Hand-offs
- <sub-agent dispatched / next session expected to ...>
## Open questions
- <open question 1>
## Next session
<one-line statement of the next session's intent>
Extraction rules
- No verbatim copying. Summarise decisions and their reasons; drop exploratory chatter, rhetoric, and repeated clarifications.
- Decisions: only items the user explicitly confirmed or the Leader explicitly ACCEPTed.
- Rejected alternatives: options that were discussed and turned down; include a one-line concrete reason.
- Hand-offs: list sub-agents dispatched in this session, or explicitly state what the next session should pick up.
- Open questions: items that didn't converge this session and need a decision next time.
- Don't record tool-call details (e.g. "Read foo.md / Edit bar.md"); only why something was read / changed and the result.
- Timeline keeps only milestones: e.g. "§How.3 round 1 accepted", "Code Reviewer dispatch produced 7 BLOCKERs".
- Never leak secrets: if the JSONL contains tokens / PEM / API keys, delete them, never copy into the meeting log (even if the file itself is private).
Verification checklist
- Filename format
YYYY-MM-DD_<topic-kebab>.md, date in local timezone. - Contains the five main sections: Goal / Decisions / Rejected alternatives / Hand-offs / Open questions / Next session.
- Entries are summaries, never verbatim copies.
- No secrets / tokens / PII.
- If the session spans multiple days, add a phase tag to the topic (e.g.
kickoff/spec-phase/cr-round1).
Deviation considerations
- Session is too short (< 5 meaningful turns): a standalone log isn't necessarily warranted; append as an addendum to the previous log.
- Session was highly divergent: split into multiple topic-specific logs for the same day, named
{date}_{topic-a}.md/{date}_{topic-b}.md. - Sub-agent internal exchanges: usually not included in the meeting log; only record the main agent's dispatch + summary of the returned result.
Related skills
methodology-pattern-extractor: meeting logs produced here are the input for methodology pattern extraction.backlog-routing-by-topic: open questions that can be classified can also be routed to the matching file's §Backlog.
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.